Installation

The Zero Runtime Python SDK lets you build voice AI agents on Python 3.11+ with a clean, type-hinted API.

Prerequisites

Before installing, make sure you have:

Python 3.11 or later
A Zero Runtime auth token — get these from the Zero Runtime dashboard
API keys for any AI/voice providers you plan to use (e.g., STT, TTS, LLM providers)

Install the SDK via pip:

pip install zeroruntime

Point the worker at your runtime address, and set your auth token, using the values from the dashboard:

export ZERORUNTIME_TARGET=us2.zeroruntime.ai:443
export ZERORUNTIME_AUTH_TOKEN=<your-auth-token>

Once installed, keep these conventions in mind as you build:

Agents subclass Agent and implement the async def on_enter and on_exit hooks.
Tools use the @function_tool decorator — the schema is automatically inferred from type hints and the docstring.
Provider plugins are imported from zrt.plugins.

Follow the Quickstart guide to build your first complete agent.
Browse runnable examples in the zeroruntime-python-examples and zeroruntime-js-examples repositories.