> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.voicebip.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.voicebip.com/_mcp/server.

# Python SDK

> Install and use the voicebip Python package.

The Python SDK is auto-generated from the OpenAPI spec via Fern and will be published to PyPI in Phase 2.

## Installation (Coming Soon)

```bash
pip install voicebip
```

## Preview Usage

```python
from voicebip import Voicebip

client = Voicebip(api_key="pk_live_xxx")

# Create an agent
agent = client.agents.create(
    display_name="Customer Support",
    language="en",
    system_prompt="You are a helpful agent.",
)

# Provision a number
number = client.numbers.provision(
    number_id="num_xxx",
    agent_id=agent.agent_id,
    channels=["voice"],
)

print(f"Agent {agent.agent_id} assigned number {number.e164}")
```

## In the Meantime

Use the REST API directly with `requests` or `httpx`:

```python
import requests

API_KEY = "pk_live_xxx"
BASE_URL = "https://api.voicebip.com/v1"
headers = {"Authorization": f"Bearer {API_KEY}", "Content-Type": "application/json"}

# Create agent
resp = requests.post(f"{BASE_URL}/agents", headers=headers, json={
    "display_name": "My Agent",
    "language": "en",
})
agent = resp.json()
print(agent["agent_id"])
```