Pre-requisites
Before using the PolyAI ADK, you need both the correct platform access and the required local tools.
Platform access¶
To use the ADK, you must have:
- access to a workspace in PolyAI Agent Studio
- a valid API key
Access and API credentials are provided by your PolyAI contact.
If you need access to the PolyAI platform, contact:
developers@poly-ai.com
Local requirements¶
You will also need the following installed on your machine:
-
Python 3.14 or higher
The ADK requires a modern Python runtime.
-
uv
Recommended for local development setup from source.
-
Git
Required if you plan to clone the repository or contribute from source.
Install uv¶
If you use Homebrew on macOS, you can install uv with:
Before you continue¶
Before moving on, make sure you have:
- confirmed access to Agent Studio
- obtained an API key
- installed Python 3.14+
- installed
uvif you are using the development setup - confirmed that Git is available locally
Next step¶
Once these requirements are in place, continue to installation.
-
Installation
Install the ADK and set up your local environment. Open installation