# Quickstart

> Run the A2A starter agent with a CopilotKit chat UI.

## Start with your coding agent [#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.

<PageAgentPrompt />

## Prerequisites [#prerequisites]

Before you begin, you'll need the following:

- A Google Gemini API key
- Node.js 20+
- Python 3.13+
- [uv](https://docs.astral.sh/uv/)
- Your favorite package manager

## Getting started [#getting-started]

<Steps>
    <Step>
        ### Set up CopilotKit Intelligence [#set-up-copilotkit-intelligence]

        <SignupLink surface="docs_a2a_quickstart_step1">Sign in to cloud-hosted Intelligence</SignupLink>. 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.
    </Step>

    <Step>
        ### Clone the A2A starter template [#clone-the-a2a-starter-template]

        ```bash
        git clone https://github.com/copilotkit/with-a2a-a2ui.git
        cd with-a2a-a2ui
        npx copilotkit@latest project select
        ```

        `project select` creates or selects an Intelligence project and writes its server-side API key to `.env` as `CPK_INTELLIGENCE_API_KEY`.
    </Step>
    <Step>
        ### Install dependencies [#install-dependencies]

        ```
        pnpm install
        ```
    </Step>
    <Step>
        ### Configure your environment [#configure-your-environment]

        Create a `.env` file in your agent directory and add your Google API key:

        ```plaintext title="agent/.env"
        GEMINI_API_KEY=your_gemini_api_key
        ```

        <Callout type="info" title="What 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.
        </Callout>
    </Step>
    <Step>
        ### Start the development server [#start-the-development-server]

        <Tabs groupId="package-manager" items={['npm', 'pnpm', 'yarn', 'bun']}>
            <Tab value="npm">
                ```bash
                npm run dev
                ```
            </Tab>
            <Tab value="pnpm">
                ```bash
                pnpm dev
                ```
            </Tab>
            <Tab value="yarn">
                ```bash
                yarn dev
                ```
            </Tab>
            <Tab value="bun">
                ```bash
                bun dev
                ```
            </Tab>
        </Tabs>

        This will start both the UI and agent servers concurrently.
    </Step>
    <Step>
        ### Start chatting [#start-chatting]

        Your AI agent is now ready to use. Navigate to `localhost:3000` and start prompting it:

        ```
        Show me chinese restaurants in NYC
        ```

        <Accordions className="mb-4">
            <Accordion title="Troubleshooting">
                - If you're having connection issues, try using `0.0.0.0` or `127.0.0.1` instead of `localhost`
                - Make sure your agent is running on port 10002
                - Check that your Google API key is correctly set
            </Accordion>
        </Accordions>

    </Step>

    <Step>
        ### Open Inspector and confirm setup [#open-inspector-and-confirm-setup]

        On localhost, click the Inspector button in the corner of the app.

        1. Open **Inspect**, then **Agent**. Your agent is listed.
        2. Send a chat message. Open **Inspect**, then **AG-UI Events**. Events are moving.
        3. Open **Rich Threads**. The list is unlocked (Intelligence is on), or locked with **Copy setup prompt** (Intelligence is off).

        More detail: [Inspector](/a2a/inspector).
    </Step>

</Steps>

## What's next? [#whats-next]

Now that you have your basic agent setup, explore these advanced features:

<Cards>
  <Card
    title="Add some generative UI"
    description="Render declarative UI components with A2UI."
    href="/a2a/generative-ui/declarative-a2ui"
    icon={<PaintbrushIcon />}
  />
</Cards>
