Maxim
f3dc78891b
The Prerequisites table in examples/integrations/agentcore/README.md picked up a uv row whose URL is wider than the existing column padding, leaving the table unaligned against oxfmt (the repo formatter covers .md — see the lint-fix glob in lefthook.yml). Re-run oxfmt --write on that one file. locals.tf fails tofu fmt on a pre-existing misalignment in the Lambda source-path block that this branch did not introduce; since the file is already in this branch's diff, align it here so every changed .tf file passes tofu fmt -check. Scoped to locals.tf only — modules/backend/copilotkit_runtime.tf has the same class of debt but is out of this diff and is left alone. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
4.7 KiB
CopilotKit + AWS AgentCore
Chat UI with generative charts, shared-state todo canvas, and inline tool rendering — deployed on AWS Bedrock AgentCore. Pick LangGraph or Strands.
Prerequisites
| Tool | Version |
|---|---|
| AWS CLI | configured (aws configure) |
| Node.js | 18+ |
| uv | any recent release |
| Docker | running |
The Python side is managed entirely by uv — it provisions the interpreter, so there is no separate Python install step.
Deploy to AWS
-
Create your config:
cp config.yaml.example config.yaml # Edit config.yaml — set stack_name_base and admin_user_email -
Deploy:
./deploy-langgraph.sh # LangGraph agent (infra + frontend) ./deploy-langgraph.sh --skip-frontend # infra/agent only ./deploy-langgraph.sh --skip-backend # frontend only # or ./deploy-strands.sh # AWS Strands agent ./deploy-strands.sh --skip-frontend ./deploy-strands.sh --skip-backend -
Open the Amplify URL printed at the end. Sign in with your email.
Local Development
cd docker
cp .env.example .env
# Fill in AWS creds — STACK_NAME, MEMORY_ID, and aws-exports.json are auto-resolved
./up.sh --build
- Frontend → hot reloads on save (volume mount + Vite)
- Agent → rebuild on changes:
docker compose up --build agent - Browser →
http://localhost:3000, auth redirects back to localhost
The full chain runs locally: browser:3000 → bridge:3001 → agent:8080. AWS is only used for Memory and Gateway (SSM/OAuth2).
See docs/LOCAL_DEVELOPMENT.md for full details.
Agent dependencies
Each single-agent directory under agents/ — langgraph-single-agent/ and
strands-single-agent/ — is its own uv project with its own uv.lock, and the
Dockerfiles install with uv sync --locked — so the image gets exactly the
dependency set in the lockfile, not whatever resolves that day. agents/utils/
is the exception: it is shared source that both Dockerfiles COPY in, not a
project, so it has no pyproject.toml or lockfile of its own and anything it
imports must be declared in each agent that copies it.
cd agents/langgraph-single-agent
uv add some-package # or edit pyproject.toml, then: uv lock
Either way, commit the updated uv.lock alongside pyproject.toml. Terraform
hashes both, so a dependency change retriggers the image build on the next apply.
What's inside
| Piece | What it does |
|---|---|
frontend/ |
Vite + React with CopilotKit chat, charts, todo canvas |
agents/langgraph-single-agent/ |
LangGraph agent with tools + shared todo state |
agents/strands-single-agent/ |
Strands agent with tools + shared todo state |
pyproject.toml / uv.lock |
Dependencies for the scripts/ helpers |
infra-cdk/ |
CDK: Cognito, AgentCore, CopilotKit Lambda bridge, Amplify |
infra-terraform/ |
Terraform equivalent — see infra-terraform/README.md |
docker/ |
Local dev via Docker Compose |
docs/ |
LOCAL_DEVELOPMENT.md, LOCAL_DOCKER_TESTING.md |
Architecture
Browser → API Gateway → CopilotKit Lambda (Node.js, AG-UI bridge)
↓
AgentCore Runtime
↓
langgraph_agent.py / strands_agent.py
↓ MCP (OAuth2 M2M)
AgentCore Gateway → Lambda tools
Auth: Cognito OIDC → Bearer token forwarded from browser through Lambda to AgentCore.
Tear down
cd infra-cdk && npx cdk@latest destroy --all --output ../cdk.out-lg # LangGraph stack
cd infra-cdk && npx cdk@latest destroy --all --output ../cdk.out-st # Strands stack