jambonz-sdk 0.1.0

Python SDK for the jambonz open-source telephony platform

jambonz-sdk

Python SDK for the jambonz open-source telephony platform.

Installation

# Core package — webhook response builder + REST API client
pip install jambonz-sdk

# With WebSocket support
pip install jambonz-sdk[websocket]

Quick start

Webhook handler

from jambonz import WebhookResponse

def handle_call(data: dict) -> list:
    response = WebhookResponse()
    response.say("Hello from jambonz!")
    return response.build()

WebSocket app (requires jambonz-sdk[websocket])

from jambonz.websocket import JambonzWebSocketApp

app = JambonzWebSocketApp()

@app.on("/voice")
async def handle_session(session):
    await session.say("Welcome!")
    await session.hangup()

app.run(host="0.0.0.0", port=3000)

REST client

from jambonz.client import JambonzClient

client = JambonzClient(base_url="https://my-jambonz.example.com", api_key="...")
accounts = await client.accounts.list()

Features

• Webhook response builder — fluent API for composing jambonz verb arrays
• REST API client — async HTTP client wrapping every jambonz REST endpoint
• WebSocket server — full-duplex call control with session management and routing
• Audio streaming — bidirectional audio stream helpers
• Pydantic models — fully typed request/response models
• HMAC signature verification — validate inbound webhook authenticity

Development

git clone https://github.com/jambonz/jambonz-python-sdk.git
cd jambonz-python-sdk
pip install -e ".[dev]"
pytest

License

MIT