# SIPHON: The Missing Layer Between AI Models and Telephony

**Project Overview**:
Siphon is an open-source Python framework for building production-grade AI calling agents. It abstracts the complex infrastructure of telephony—handling WebSockets, audio buffering, state management, and SIP signaling—so developers can build reliable calling agents in minutes, not months.

**Key Capabilities**:
• **Telephony First**: Native SIP signaling and trunking management.
• **Sub-500ms Latency**: Powered by LiveKit WebRTC for real-time, human-like conversations.
• **Model Agnostic**: Plug-and-play with OpenAI, Anthropic, Deepgram, Cartesia, ElevenLabs, or local models.
• **State Management**: Preserves context across interruptions and latency spikes.
• **Horizontal Scaling**: Zero-config auto-scaling. Run on 1 or 1,000 servers immediately.

**Installation**:
`pip install siphon-ai`

**Quick Start**:
```python
from siphon.agent import Agent
from siphon.plugins import openai, cartesia, deepgram
from dotenv import load_dotenv

load_dotenv()

# 1. Configure Plugins
llm = openai.LLM()
tts = cartesia.TTS()
stt = deepgram.STT()

# 2. define the Agent
agent = Agent(
    agent_name="receptionist",
    llm=llm,
    tts=tts,
    stt=stt,
    system_instructions="You are a helpful receptionist..."
)

# 3. Run the Worker
if __name__ == "__main__":
    # One-time setup for fresh environments
    agent.download_files()
    agent.dev()
```

**Documentation Resources**:
• **Documentation Home**: https://siphon.blackdwarf.in/docs
• **Quick Start Guide**: https://siphon.blackdwarf.in/docs/overview/getting-started
• **Inbound Calls**: https://siphon.blackdwarf.in/docs/calling/inbound/overview
• **Outbound Calls**: https://siphon.blackdwarf.in/docs/calling/outbound/overview
• **GitHub Repository**: https://github.com/blackdwarftech/siphon