Introduction

SIPHON is a production-ready Python framework that makes building AI telephony agents as simple as writing a few lines of code. It abstracts away the plumbing of SIP and voice AI orchestration, letting you focus on the conversation logic.

SIPHON handles:

• SIP signaling: Connecting to providers like Twilio, Telnyx, or any other SIP provider.
• Media transport: Managing realtime audio streams.
• AI orchestration: Streaming audio to STT, LLM, and TTS models with low latency.

Why SIPHON?

Traditional telephony development is painful. You have to manage SIP trunks, handle real-time media streams, integrate VAD (Voice Activity Detection), and wire up LLMs (Large Language Models), STT (Speech-to-Text), and TTS (Text-to-Speech) manually.

SIPHON is designed to solve this by providing:

• Simplicity: Define a complete voice agent in a few lines of Python.
• Vendor agnostic: Swap OpenAI for Anthropic, or Deepgram for AssemblyAI, with a simple config change.
• Production-ready: Built-in support for call recording, metadata persistence, and transcript storage.
• PSTN-first: Native integration with SIP providers (Twilio, Telnyx, etc.) for real phone calls.

How it works

SIPHON acts as the "brain" between your Telephony Provider and your AI infrastructure.

1. Inbound Call: A user calls your Twilio/Telnyx number.
2. SIP Dispatch: SIPHON routes the call to your agent worker.
3. Agent Logic: SIPHON spins up a worker that joins the room.
4. AI Conversation: The worker listens, transcribes, thinks (LLM), and speaks back—all in real-time.

The same orchestration works for outbound calling too: SIPHON can place calls and connect them to your agent logic.

Production & Scaling

To scale your agent for production, simply run the agent on multiple servers. This architecture allows for "Zero Config" horizontal scaling—it automatically detects new workers and load balances incoming calls across them. Learn more about Scaling.

System Architecture

For a deeper look at how SIPHON orchestrates these components, here is the system overview:

Getting Started

Ready to build your first agent? Check out the Getting Started guide to install SIPHON and make your first call in under 10 minutes.