polyai/adk

Agent Development Kit (ADK)

A CLI for building, testing, and deploying PolyAI voice and chat agents.

New to PolyAI? Sign up at studio.poly.ai and start free.

Documentation

Installation

Via UV:

uv tool install polyai-adk

Via Pip:

pip install polyai-adk

Voice calling (poly call) needs extra audio and WebRTC dependencies, which are left out of the default install to keep it small for CI. Install them with the call extra:

pip install "polyai-adk[call]"
uv tool install "polyai-adk[call]"

Then set up your account, API key, AI skills, and a project:

poly setup

Once set up, use the poly command to manage your projects:

poly setup      # Set up everything: account, API key, AI skills, and a project
poly apikey     # Get an API key for the PolyAI APIs / Dialog RSN (separate from ADK setup; pass --region for your cluster)
poly init       # Initialize a project
poly project    # Manage poly projects
poly pull       # Pull latest configuration
poly push       # Push local changes
poly status     # View project status
poly diff       # View local changes
poly branch     # Manage branches
poly format     # Format resources
poly validate   # Validate configuration
poly review     # Create a review gist
poly deployments