Python SDK

The Patter Python SDK lets you connect AI voice agents to phone numbers in minutes. Power inbound call centers, outbound dialers, and conversational AI experiences with minimal code.

Installation

pip install getpatter

Requirements

Python 3.11 or higher
A telephony account — Twilio or Telnyx (both fully supported)
An AI provider key (OpenAI, ElevenLabs, or Deepgram)

Minimal Example

import asyncio
from getpatter import Patter, Twilio, OpenAIRealtime

phone = Patter(carrier=Twilio(), phone_number="+15550001234")    # TWILIO_* from env
agent = phone.agent(engine=OpenAIRealtime(), system_prompt="You are a friendly receptionist.")
asyncio.run(phone.serve(agent))                                  # OPENAI_API_KEY from env

That’s the full file. Every provider class reads its API key from an env var when you omit api_key= — so as long as you have TWILIO_ACCOUNT_SID, TWILIO_AUTH_TOKEN, and OPENAI_API_KEY set, the example above is paste-runnable.

How Patter runs

Patter runs entirely in your own process. You bring your own telephony (Twilio or Telnyx) and AI provider credentials — no external platform or hosted backend required.

A hosted Patter Cloud option will return in a future release.

What’s Next

Quickstart

Connect your first agent to a phone number.

Configuration

All constructor parameters and options.

Agents

Configure voice, model, tools, and guardrails.

Engines

OpenAI Realtime, ElevenLabs ConvAI.

LLM

Pipeline mode and custom LLMs.

Tools

Function calling and webhook integrations.

Quickstart

​Python SDK

​Installation

​Requirements

​Minimal Example

​How Patter runs

​What’s Next

Quickstart

Configuration

Agents

Engines

LLM

Tools

Python SDK

Installation

Requirements

Minimal Example

How Patter runs

What’s Next