AWS AgentCore

CopilotKit + AWS AgentCore

AWS Bedrock AgentCore gives you a secure, serverless runtime for deploying AG-UI agents at scale — handling auth, session isolation, and infrastructure. CopilotKit gives those agents a production-ready frontend:

Chat UI · Shared State · Generative UI · Human-in-the-loop

How it works

The two connect through CopilotKit Runtime, a lightweight server-side layer that sits between your browser and AgentCore. It's the same runtime you'd use with any CopilotKit-powered agent — AgentCore just requires it to run server-side (browsers can't call AgentCore directly due to SigV4/OAuth2 authentication).

Browser → CopilotKit Runtime → AgentCore Runtime → your agent

What you get

Chat UI — prebuilt chat interface, or headless hooks to build your own
Shared state — bidirectional sync between agent state and your React UI
Generative UI — render custom components from tool calls in real time
Human-in-the-loop — let users review, approve, or redirect agent actions
AgentCore memory — conversation history persists across sessions via AgentCore's memory layer

Quickstart

AWS CLI required

Both paths below require AWS credentials configured locally. If you haven't done this yet, follow the AWS CLI getting started guide before continuing.

Choose your starting point

Start fresh with our CLI, or connect CopilotKit to an agent you've already deployed on AgentCore.

Start from scratch

Scaffold a complete AgentCore + CopilotKit application with one command.

I already have an agent

I've followed the AWS guide and have an AG-UI agent deployed on AgentCore Runtime.

Run the CLI

npx copilotkit@latest create -f agentcore-langgraph

The CLI downloads the full AgentCore template and sets up config.yaml for you.

Configure

Open config.yaml and set your details:

stack_name_base: my-agentcore-app   # prefix for all AWS resources (max 35 chars)
admin_user_email: you@example.com   # where your Cognito invite will be sent

Deploy

One command deploys everything — CDK infrastructure, AgentCore Runtime, and the frontend:

./deploy-langgraph.sh

🎉 Open your app

The deploy script prints an Amplify URL when it finishes. Open it and sign in with your admin_user_email.

Run locally

To run the full stack locally — agent, CopilotKit runtime, and frontend — without deploying:

cd docker
cp .env.example .env
# Fill in AWS credentials and STACK_NAME
./up.sh --build

Service	Port	Description
`agent`	8080	Your agent, hot-reloads on `.py` changes
`runtime`	3001	CopilotKit Runtime
`frontend`	3000	Vite dev server

Tear down

When done, delete all AWS resources to stop charges:

cd infra-cdk && npx cdk destroy --all

What's next?

🎨

Generative UI

Render custom React components directly from your agent's tool calls.

🔄

Shared State

Sync structured state between your agent and your React UI bidirectionally.