> ## Documentation Index
> Fetch the complete documentation index at: https://docs.poly.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# PolyAI ADK Docs

<img src="https://mintcdn.com/polyai/Q1iSzph0uOFxTBjX/adk/assets/poly-ai-adk.png?fit=max&auto=format&n=Q1iSzph0uOFxTBjX&q=85&s=bcef2795d4900ebadd38a402e746f726" alt="PolyAI ADK" width="1700" height="640" data-path="adk/assets/poly-ai-adk.png" />

Build and edit Agent Studio projects locally with the **PolyAI ADK**, then push them back to Agent Studio to review and deploy.

The ADK gives you a local, Git-like workflow for Agent Studio projects: pull, edit with standard tooling, validate, and push.

## From zero to a local project

A few commands take you from an empty machine to a working local copy of your agent:

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
curl -LsSf https://astral.sh/uv/install.sh | sh   # install uv (skip if you have it)
uv venv --python=3.14 --seed
source .venv/bin/activate
pip install polyai-adk
poly start                                          # self-serve sign-up, API key, and project in one go
```

`poly start` is for self-serve accounts on [studio.poly.ai](https://studio.poly.ai). If your workspace is on an enterprise cluster (`us-1`, `euw-1`, `uk-1`), run `poly login --region <region>` instead — or export your API key manually. See [Getting started](/adk/get-started/get-started#enterprise-accounts-poly-login-or-manual-api-key).

See [Getting started](/adk/get-started/get-started) for the full walkthrough, [Prerequisites](/adk/get-started/prerequisites) for local tool setup, and [First commands](/adk/get-started/first-commands) for a guide to `poly init` and the core CLI.

## Start here

<CardGroup>
  <Card title="Not sure where to start?" href="/adk/get-started/get-started">
    Build a working voice agent from your website in minutes, then pull it into the ADK.
  </Card>

  <Card title="What is the ADK?" href="/adk/get-started/what-is-the-adk">
    Understand what the ADK does and where it fits in the Agent Studio workflow.
  </Card>

  <Card title="Build an agent" href="/adk/tutorials/build-an-agent">
    Follow the end-to-end workflow from project setup to deployment.
  </Card>

  <Card title="CLI reference" href="/adk/reference/cli">
    See every `poly` command and its flags.
  </Card>
</CardGroup>

## What this site covers

This documentation follows the developer journey:

* understanding what the ADK is and how it fits into Agent Studio
* installing it and running the first commands
* building, reviewing, and deploying agents
* reference for all CLI commands, resource types, and tooling

## Recommended path

If you are new to the ADK, follow this order:

1. follow **Getting started** — install the ADK, set up your API key (`poly start` for self-serve, `poly login` or a manual export for enterprise), and create your first project
2. read **What is the PolyAI ADK?**
3. use **First commands** — explore the core CLI commands
4. continue to **Build an agent with the ADK**