# 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.

This is a Grok-Wiki source-grounded repository wiki. Use the complete Markdown link when an agent needs the full repo context.

## Context Links

- [Complete Markdown wiki](https://grok-wiki.com/public/wiki/patterai-patter-57d14e233afc/llms-full.txt)
- [Complete Markdown alias](https://grok-wiki.com/public/wiki/patterai-patter-57d14e233afc.md)
- [Human interactive wiki](https://grok-wiki.com/public/wiki/patterai-patter-57d14e233afc)
- [GitHub repository](https://github.com/PatterAI/Patter)

## Repository

- Repository: PatterAI/Patter

- Generated: 2026-05-27T19:17:53.037Z
- Updated: 2026-05-27T22:41:12.507Z
- Runtime: Pi · Claude Code · claude-sonnet-4-6:high
- Format: Technical
- Pages: 6

## Pages

- [Technical Orientation](https://grok-wiki.com/public/wiki/patterai-patter-57d14e233afc/pages/01-technical-orientation.md): What 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.
- [Carrier & Telephony Layer](https://grok-wiki.com/public/wiki/patterai-patter-57d14e233afc/pages/02-carrier-telephony-layer.md): How 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.
- [Voice Engines — Realtime, ConvAI & Pipeline Mode](https://grok-wiki.com/public/wiki/patterai-patter-57d14e233afc/pages/03-voice-engines-realtime-convai-pipeline-mode.md): The 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.
- [STT & TTS Provider Catalog](https://grok-wiki.com/public/wiki/patterai-patter-57d14e233afc/pages/04-stt-tts-provider-catalog.md): All 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.
- [LLM Providers, Tool Calling & Guardrails](https://grok-wiki.com/public/wiki/patterai-patter-57d14e233afc/pages/05-llm-providers-tool-calling-guardrails.md): The 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.
- [Dashboard, Observability, Tunneling & Deployment](https://grok-wiki.com/public/wiki/patterai-patter-57d14e233afc/pages/06-dashboard-observability-tunneling-deployment.md): The 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.

## Source Files

- `dashboard-app/src/App.tsx`
- `docker-compose.yml`
- `Dockerfile`
- `libraries/python/getpatter/_public_api.py`
- `libraries/python/getpatter/carriers/telnyx.py`
- `libraries/python/getpatter/carriers/twilio.py`
- `libraries/python/getpatter/client.py`
- `libraries/python/getpatter/engines/elevenlabs.py`
- `libraries/python/getpatter/engines/openai_realtime_2.py`
- `libraries/python/getpatter/engines/openai.py`
- `libraries/python/getpatter/integrations/patter_tool.py`
- `libraries/python/getpatter/llm/anthropic.py`
- `libraries/python/getpatter/llm/groq.py`
- `libraries/python/getpatter/llm/openai.py`
- `libraries/python/getpatter/models.py`
- `libraries/python/getpatter/observability/`
- `libraries/python/getpatter/providers/base.py`
- `libraries/python/getpatter/server.py`
- `libraries/python/getpatter/stream_handler.py`
- `libraries/python/getpatter/stt/deepgram.py`
- `libraries/python/getpatter/stt/openai_transcribe.py`
- `libraries/python/getpatter/stt/whisper.py`
- `libraries/python/getpatter/telephony/common.py`
- `libraries/python/getpatter/telephony/telnyx.py`
- `libraries/python/getpatter/telephony/twilio.py`
- `libraries/python/getpatter/test_mode.py`
- `libraries/python/getpatter/tools/`
- `libraries/python/getpatter/tts/cartesia.py`
- `libraries/python/getpatter/tts/elevenlabs.py`
- `libraries/python/getpatter/tts/openai.py`
- `libraries/python/getpatter/tunnel.py`
- `libraries/python/getpatter/tunnels/`
- `libraries/typescript/src/client.ts`
- `libraries/typescript/src/engines/`
- `libraries/typescript/src/llm-loop.ts`
- `libraries/typescript/src/llm/`
- `libraries/typescript/src/pipeline-hooks.ts`
- `libraries/typescript/src/public-api.ts`
- `libraries/typescript/src/server.ts`
- `libraries/typescript/src/stream-handler.ts`
- `libraries/typescript/src/types.ts`
- `README.md`