---
id: phonic
version: "0.32.21"
license: MIT
license_treatment: permissive
maintenance: active
---

# phonic

License: permissive · Maintenance: active · Downloads: 190.9K/mo

## What it is and what it does

Phonic is a generated Python SDK that wraps the Phonic voice agent APIs, allowing developers to programmatically create, configure, and manage voice agents for telephony applications. It provides both synchronous and asynchronous clients, with support for real-time websocket communication for low-latency interactions. The library handles agent setup (voice selection, language configuration, system prompts, template variables) and includes features like automatic retries with exponential backoff, custom timeout configuration, and access to raw response data.

The package depends on httpx for HTTP communication, pydantic for request/response validation, and websockets for real-time connections. It supports Python 3.8 through 3.15 and is designed to be cross-platform. The SDK is actively maintained and recently released, with no known security vulnerabilities. Exception handling is provided through ApiError subclasses for non-success HTTP responses.

Use it for:

- Build automated customer support agents that handle inbound calls with customizable prompts and multilingual capabilities.
- Create voice-based interactive systems with template variables, pronunciation dictionaries, and keyword boosting for better speech recognition.
- Develop real-time voice applications using async/await patterns and websocket connections for low-latency agent interactions.
- Integrate voice agent management into larger applications with configurable endpoints, custom HTTP clients, and proxy support.
- Handle complex agent configurations including timezone-aware scheduling, audio speed control, and background noise management.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Phonic is a Python client library for accessing the Phonic APIs, which provide voice agent creation and management capabilities including real-time websocket communication.

Yes. The package has low install friction, active maintenance, no known vulnerabilities, and a permissive MIT license. It is suitable for production use if you are building applications that integrate with the Phonic voice agent service. The main consideration is that you must have a valid Phonic API account and credentials to use it effectively.

## Install

pip install phonic
uv add phonic
poetry add phonic

## Installing phonic

Before you install: Low install friction with a pure Python wheel distribution. The package is actively maintained with a recent release (8 days old) and depends on standard, well-established libraries (httpx, pydantic, websockets).

License in practice: MIT license permits commercial use, modification, and distribution with minimal restrictions, making it suitable for most production and proprietary projects.

Quickstart:

pip install phonic

from phonic import Phonic

client = Phonic(api_key="your-api-key")
agent = client.agents.create(
    project="main",
    name="support-agent",
    phone_number="assign-automatically",
    timezone="America/Los_Angeles",
    voice_id="sabrina"
)

Requires a valid Phonic API key to authenticate requests.

Verify before relying:

- Whether the Phonic API service itself requires authentication credentials beyond the api_key parameter shown in examples
- Rate limits or quota constraints imposed by the Phonic service on API calls
- Whether websocket connections require additional setup or permissions beyond client instantiation

## Package facts

- License: MIT (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 190.9K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

voice agent api client, phonic api python, ai voice agent sdk, telephony api client, conversational ai platform, voice-api, telephony, async-ready

[View on SkillFed](https://skillfed.io/packages/phonic) · [View on PyPI](https://pypi.org/project/phonic/)