Agent-readable wiki

Patter SDK Developer Reference

Patter is an open-source Python and TypeScript SDK that connects AI agents to real phone calls via Twilio or Telnyx, handling telephony signaling, STT, TTS, and real-time audio streaming through a unified 4-line API. Both language SDKs expose an identical surface — the same carriers, engines, providers, and hooks — so cross-runtime teams can ship voice agents without rewriting business logic.

Pages

  1. Technical OrientationWhat Patter is, its end-to-end call data flow, the Patter / agent / serve three-object model, SDK entry points in both Python and TypeScript, and how the rest of this reference is organized.
  2. Carrier & Telephony LayerHow Twilio and Telnyx carrier adapters are structured, the WebSocket and webhook call-control handshakes, inbound vs. outbound call flows, DTMF, AMD, call transfer, voicemail drop, and recording parity between carriers.
  3. Voice Engines — Realtime, ConvAI & Pipeline ModeThe three voice architectures: speech-to-speech engines (OpenAI Realtime, ElevenLabs ConvAI) vs. the STT→LLM→TTS pipeline, how engine adapters implement the shared engine interface, barge-in and VAD semantics, and latency trade-offs for each mode.
  4. STT & TTS Provider CatalogAll supported speech-to-text (Deepgram, Whisper, OpenAI Transcribe, AssemblyAI, Cartesia, Soniox, Speechmatics) and text-to-speech (ElevenLabs, Cartesia, OpenAI, LMNT, Rime, Inworld) adapters — their configuration, streaming contracts, known limitations, and how to swap providers in pipeline mode.
  5. LLM Providers, Tool Calling & GuardrailsThe LLM backend adapters (OpenAI, Anthropic, Groq, Cerebras, Google Gemini), the tool decorator and Tool dataclass for in-process and webhook-dispatch tools, output guardrail rules, dynamic variable substitution, and the PatterTool integration for LangChain / OpenAI Assistants orchestrators.
  6. Dashboard, Observability, Tunneling & DeploymentThe built-in real-time monitoring dashboard, vendor-neutral OpenTelemetry tracing, call metrics and cost tracking, Cloudflare quick-tunnel vs. static webhook URL trade-offs, test mode (no phone required), Docker Compose setup, and the agent skills bundle for AI coding assistants — the complete operational surface for running Patter in development and production.

Complete Markdown

The complete agent-readable Markdown files are published separately from this HTML page.