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

The Python side is managed entirely by uv — it provisions the interpreter, so there is no separate Python install step.

Deploy to AWS

1. Create your config:

   bashCopy

   cp config.yaml.example config.yaml
   # Edit config.yaml — set stack_name_base and admin_user_email
   

2. Deploy:

   bashCopy

   ./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
   

3. 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

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

Docs

• CopilotKit
• AWS Bedrock AgentCore
• Local Development
• Local Docker Testing