Patter

四行代码给AI代理装电话,开源可控的语音SDK。

Patter 是一个开源的语音 AI SDK,旨在成为 Vapi 和 Retell 的替代方案,让开发者能够完全掌控自己的语音代理技术栈。它解决了构建电话语音代理时集成复杂、成本高昂且受制于闭源平台的问题。核心能力是提供简洁的 Python 和 TypeScript API,仅需四行代码即可为 AI 代理绑定一个可用的电话号码。它基于 MIT 许可证,支持 Twilio、Telnyx 和 Plivo 等主流电话服务提供商,并深度集成 OpenAI 的 Realtime API,实现低延迟的语音交互。项目还包含 Hermes Agent 等组件,支持构建复杂的对话逻辑,适合需要定制化语音交互的开发者。

开源 free 智能体
访问官网 ↗ GitHub ↗ 文档 ↗
GitHub 星标 ★ 1062
维护状态 较活跃
是否开源 是
定价模式 free

项目数据

分类智能体
开发团队PatterAI
所属国家
定价模式free
价格说明开源SDK,MIT许可,完全免费,可自行部署使用。
访问状态
是否开源是
开源协议MIT
主要语言Python
技术栈/模型ai-agent,ai-phone-agent,hermes-agent,llm,mastra,open-source,openai,openclaw,python,realtime-api,sdk,speech-to-text,telnyx,text-to-speech,twilio,typescript,vapi-alternative,voice-agent,voice-ai,voicebot
GitHub 星标★ 1062
30天Star增速
HF 下载量
上线时间2026-04-07 00:00:00
最近更新2026-09-22 00:00:00
维护状态较活跃
中文支持
访问方式
移动端支持
综合评分
收录时间2026-08-09
浏览次数2

使用教程

难度:进阶 约 15 分钟 部署方式:库/依赖 6 步

环境要求

  • Python 环境(用于 pip install getpatter)
  • Node.js 环境(如需 npm install getpatter 使用 TypeScript API)
  • Twilio、Telnyx 或 Plivo 等电话服务商账号凭证
  • OpenAI API Key(默认支持 OpenAI Realtime API)

安装与启动步骤

  1. 1安装 Python SDK

    用 pip 安装官方包 getpatter,这是 Python 侧接入 Patter 的唯一依赖,README 徽章给出的命令就是这个。

    pip install getpatter
  2. 2安装 TS/JS SDK

    如果你用 TypeScript/JavaScript 开发,改用 npm 安装同名包 getpatter;只用 Python 可跳过此步。

    npm install getpatter
  3. 3配置凭证环境变量

    Patter 从环境变量读取电话服务商与模型凭证,README 举例为 TWILIO_ACCOUNT_SID 和 OPENAI_API_KEY。

    export TWILIO_ACCOUNT_SID=ACxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
    export OPENAI_API_KEY=sk-xxxxxxxxxxxxxxxxxxxxxxxx
  4. 4编写并运行代理

    用 Python API 为 AI 代理绑定电话号码,构建代理逻辑、语音转写与实时语音;完整示例见官方文档。

  5. 5切换电话服务商

    把代码中的 Twilio 换成 Telnyx 或 Plivo 即可更换运营商,同时需补齐对应运营商的凭证环境变量。

  6. 6查阅文档与模板

    官方文档 docs.getpatter.com 列出全部凭证目录,仓库还提供 Skills 与 Templates 章节可复用示例。

关键配置

配置项必填说明示例
TWILIO_ACCOUNT_SID是Twilio 账号 SID,用于接入电话网络ACxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
OPENAI_API_KEY是OpenAI 密钥,驱动 Realtime 实时语音交互sk-xxxxxxxxxxxxxxxxxxxxxxxx

如何确认成功

README 未给出明确验证方式;按文档启动代理后,拨打你绑定的电话号码确认是否能正常对话。

常见问题

Q:必须用 Twilio 吗?

A:不是。README 明确说明把 Twilio 换成 Telnyx 或 Plivo 即可切换运营商,凭证也相应换成对应服务商的。

Q:凭证写在哪里?

A:Patter 从环境变量读取服务商与模型凭证,如 TWILIO_ACCOUNT_SID、OPENAI_API_KEY,不要在代码里硬编码。

Q:支持哪些语言?

A:README 提供 Python 包(pip install getpatter)与 TypeScript/JavaScript 包(npm install getpatter),可按技术栈二选一。

Q:完整接入示例在哪看?

A:官方文档 https://docs.getpatter.com 列出了全部凭证目录与用法,仓库的 Quickstart、Skills、Templates 章节也可参考。

注意事项

  • README 未给出完整可运行的代码示例,具体 API 调用请以官方文档为准,不要照搬猜测的参数。
  • 除 Twilio 外的运营商凭证名称 README 未逐一列出,需查阅 docs.getpatter.com 的完整目录。
  • 项目基于 MIT 许可证,可自托管并完全掌控语音代理技术栈。
  • 需要自备电话号码与电话服务商账号,这部分费用由服务商收取。

核心亮点

  • 极简API,四行代码即可接入电话,上手门槛极低
  • MIT开源协议,完全掌控技术栈,无平台锁定风险
  • 同时支持Python和TypeScript,适配不同技术团队

不足之处

  • 项目较新,生态和文档成熟度待观察
  • 依赖Twilio等第三方服务,可能产生额外费用

适用场景

  • 快速构建电话客服机器人,替代传统IVR系统
  • 为个人助理或业务代理添加语音通话能力
  • 在现有应用中集成实时语音交互功能

替代项目

Vapi、Retell AI、LiveKit Agents

项目介绍

Patter 是智能体领域的开源项目,由 PatterAI 开发,是 2026 年新上线的项目。

在全站 13,090 个收录项目中,它的 GitHub 星标数(1,062)位列前 30%,在智能体分类中处于中上游。

近 42 天,它的 GitHub 星标从 1,030 增加到 1,062,净增 32。

项目保持着较活跃的维护节奏,最近一次代码更新于 2026-09-22。开源SDK,MIT许可,完全免费,可自行部署使用。从国内网络环境看,可直接访问。

它主要面向的使用场景是:快速构建电话客服机器人,替代传统IVR系统。同类可对比的替代方案包括 Vapi、Retell AI、LiveKit Agents。

上一篇:google-meta-ads-ga4-mcp

下一篇:open-reverselab

同类项目推荐

xinchao-dynamic-mind 开源

给 AI 装上疲惫和欲望,让交互更真实

独立、可自托管的 AI 动态心智状态引擎:驱动力、念头池、疲惫、睡眠与意图。

★ 199 2026-08-09
deepseek-harness 开源

把 AI 能力拆成乐高积木,拼出你的专属智能体。

DeepSeek Harness: Everything is a Plugin.

★ 233327 2026-08-15
AutoGPT 开源

开箱即用的 AI 员工,交代任务就自己干完

AutoGPT is the vision of accessible AI for everyone, to use and to build on. Our mis···

★ 187492 2026-08-09
EvoAgentX 开源

让 AI 智能体自己迭代变强,越用越聪明

EvoAgentX: Building a Self-Evolving Ecosystem of AI Agents

★ 3351 2026-09-12