aws / aws/bedrock-agentcore-starter-toolkit

[BUG] RuntimeClientError when invoking agent deployed using Starter kit direct code deployment option

Open
#356 1 comment 1 reaction 0 assignees View on GitHub
bug
Dominant language
Python
Stars
508
Forks
155
Avg merge
8h 50m
Merged PRs (30d)
4

Description

**Describe the bug**
Invoking agent deployed using Starter kit `direct code deployment ` option results in `RuntimeClientError`. This may be caused due to

**To Reproduce**
Steps to reproduce the behavior:
1. Follow instructions using starter kit available here: [Get started with Amazon Bedrock AgentCore Runtime direct code deployment](https://docs.aws.amazon.com/bedrock-agentcore/latest/devguide/runtime-get-started-code-deploy.html)
2. Invoke agent using `agentcore invoke '{"prompt":"Tell me a joke"}'`

**Expected behavior**
Agent responds with LLM generated joke.

**Error Output**
```
Invocation failed: An error occurred (RuntimeClientError) when calling the InvokeAgentRuntime operation: Runtime initialization time exceeded. Please make sure that initialization completes in 60s.
```

**Environment:**
- OS: macOS 26.0
- Python version: 3.13
- Package version: [e.g. 0.1.0]
- Installation method: agentcore starter kit

**Additional context**
Possible reasons for failure
* Incorrect starter-kit auto generated Agentcore Runtime IAM execution role
* `uv pip install --target` used by starter-kit adds absolute path to python interpreter from local environment to packaged binaries. Workaround, use `pip install --target`.

Contributor guide

Open the contributing guide

Research direction

Follow the linked Amazon Bedrock AgentCore Runtime direct code deployment guide and reproduce the failure with `agentcore invoke '{"prompt":"Tell me a joke"}'`. Inspect the starter-kit-generated runtime role and the packaging step using `uv pip install --target`, then compare the result with `pip install --target`; done means the deployed agent initializes within 60 seconds and returns a joke.

Written by the indexing model from the issue text.

Assessment

Tech stack
aws, python
Domain
cli, cloud
Issue type
Bug
Difficulty
4/5
Estimated time
3-5 days
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
35/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.