voxbridge
voxbridge is a Python SDK that puts one typed VoiceClient over the
Vapi and Retell voice-agent
platforms. Create agents, place outbound calls, verify and parse webhooks, and
answer tool calls with the same code on either provider; switching is a config
string.
Why
Voice-agent platforms diverge on nearly everything: endpoint prefixes, where the system prompt lives, webhook envelopes, signature schemes, voice-id formats. voxbridge absorbs those differences behind one small surface:
- One API, many providers: agents, calls, tools and webhooks through a
single
VoiceClient. - Typed domain models: Pydantic v2
Agent,CallandTool; every model keeps the untouched provider payload under.raw. - Normalized webhooks: each provider's envelope maps to one
WebhookEventunion, with per-provider signature verification. - Sync and async: every agent/call method has an
a-prefixed async twin. - No silent gaps: a capability a provider lacks raises
NotSupported.
Install
pip install voxbridge-sdk
Requires Python 3.12+. Runtime dependencies are httpx and pydantic only.
The distribution is named voxbridge-sdk; the package you import is voxbridge.
Where next
- Quickstart: create an agent, place a call, handle a webhook.
- Configuration: constructor options and environment variables.
- Webhooks & tools: verification, event mapping, answering tool calls.
- Providers: the Vapi-vs-Retell matrix and the differences that can bite you.
- API reference and the Changelog.