Quickstart
Run the A2A starter agent with a CopilotKit chat UI.
Start with your coding agent
Use this prompt to run the A2A starter with CopilotKit and verify a working conversation. The starter includes its own A2A agent. Your coding agent will follow this guide in your project, or you can work through the manual steps below.
Open your coding agent in your project's folder, or in an empty folder for a new app.This runs in a coding agent on your computer.
Prerequisites
Before you begin, you'll need the following:
- A Google Gemini API key
- Node.js 20+
- Python 3.13+
- uv
- Your favorite package manager
Getting started
Set up CopilotKit Intelligence
Sign in to cloud-hosted Intelligence. Cloud-hosted setup uses a server-side project API key and does not issue COPILOTKIT_LICENSE_TOKEN. You will connect the app after you clone it below.
Clone the A2A starter template
git clone https://github.com/copilotkit/with-a2a-a2ui.git
cd with-a2a-a2ui
npx copilotkit@latest project selectproject select creates or selects an Intelligence project and writes its server-side API key to .env as CPK_INTELLIGENCE_API_KEY.
Install dependencies
pnpm installConfigure your environment
Create a .env file in your agent directory and add your Google API key:
GEMINI_API_KEY=your_gemini_api_keyWhat about other models?
The starter template is configured to use Google's Gemini by default, but you can modify it to use any language model supported by ADK.
Start chatting
Your AI agent is now ready to use. Navigate to localhost:3000 and start prompting it:
Show me chinese restaurants in NYC- If you're having connection issues, try using
0.0.0.0or127.0.0.1instead oflocalhost - Make sure your agent is running on port 10002
- Check that your Google API key is correctly set
Open Inspector and confirm setup
On localhost, click the Inspector button in the corner of the app.
- Open Inspect, then Agent. Your agent is listed.
- Send a chat message. Open Inspect, then AG-UI Events. Events are moving.
- Open Rich Threads. The list is unlocked (Intelligence is on), or locked with Copy setup prompt (Intelligence is off).
More detail: Inspector.
What's next?
Now that you have your basic agent setup, explore these advanced features:
How is this guide?