> ## 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

![PolyAI ADK](https://mintcdn.com/polyai/Q1iSzph0uOFxTBjX/adk/assets/poly-ai-adk.png?fit=max\&auto=format\&n=Q1iSzph0uOFxTBjX\&q=85\&s=bcef2795d4900ebadd38a402e746f726)

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.

> [card] [View the ADK on GitHub](https://github.com/polyai/adk)
>
> Source code, issues, and releases for the `polyai-adk` CLI.

## 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](https://docs.poly.ai/adk/get-started/get-started.md#enterprise-accounts-poly-login-or-manual-api-key).

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

## Start here

> [card] [Not sure where to start?](https://docs.poly.ai/adk/get-started/get-started.md)
>
> Build a working voice agent from your website in minutes, then pull it into the ADK.

> [card] [What is the ADK?](https://docs.poly.ai/adk/get-started/what-is-the-adk.md)
>
> Understand what the ADK does and where it fits in the Agent Studio workflow.

> [card] [Build an agent](https://docs.poly.ai/adk/tutorials/build-an-agent.md)
>
> Follow the end-to-end workflow from project setup to deployment.

> [card] [CLI reference](https://docs.poly.ai/adk/reference/cli.md)
>
> See every `poly` command and its flags.

## 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**](https://docs.poly.ai/adk/get-started/get-started.md) — 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?**](https://docs.poly.ai/adk/get-started/what-is-the-adk.md)
3. use [**First commands**](https://docs.poly.ai/adk/get-started/first-commands.md) — explore the core CLI commands
4. continue to [**Build an agent with the ADK**](https://docs.poly.ai/adk/tutorials/build-an-agent.md)