dograh-hq /dograh
Open source voice AI platform. Self-hosted alternative to Vapi and Retell. On Prem, BYOK across Speech to Speech or LLM/STT/TTS, with a visual workflow builder, MCP native and telephony support.
★ 6,183⑂ 1,595👁 47⑃ 730● 190▤ 59
6,183
stars
1,595
forks
47
watchers
730
prs
190
issues
59
releases
README
Dograh AI
💡 Notice: This documentation is community-maintained. If you spot any translation inaccuracies or content that has drifted from the English version, please feel free to open a PR!
💡 提示:本文档由社区共同维护。如果您发现翻译不准确,或与英文版本存在出入,欢迎随时提交 PR!
开源、可自托管的 Vapi 与 Retell 替代方案 —— 使用可视化工作流构建器搭建生产级语音智能体,几分钟内完成测试,并让 AI 编码助手通过 MCP 帮你设计和编辑。
📖 文档 ·
📜 BSD 2-Clause ·
🌐 English ·
🌐 日本語
- 100% 开源,可自托管 —— 不像 Vapi 或 Retell,没有任何厂商绑定
- 完全可控且透明 —— 每一行代码都是开放的,LLM / TTS / STT 集成灵活可换
- 由 YC 校友与连续创业者维护,致力于让语音 AI 始终保持开放
🎥 媒体推荐
Better Stack 上手实测 —— 深入体验 Dograh
📺 想看 2 分钟产品快速演示?点这里。
⚖️ Dograh vs Vapi vs Retell
针对正在评估语音 AI 平台的团队,这里是一份在最关键的维度上诚实的对比。
| | Dograh | Vapi | Retell |
|---|---|---|---|
| 协议 | BSD 2-Clause(开源) | 闭源 | 闭源 |
| 可自托管 | ✅ 可以 —— 一条 Docker 命令 | ❌ 仅 SaaS | ❌ 仅 SaaS |
| 定价 | 免费(自托管)·按用量计费(云端) | 按分钟计费的 SaaS | 按分钟计费的 SaaS |
| 自带 LLM / STT / TTS | ✅ 任意厂商,也可使用 Dograh 自带方案 | 在其集成范围内可配置 | 在其集成范围内可配置 |
| 源码级定制 | ✅ 每行代码都可自由修改 | ❌ 闭源 | ❌ 闭源 |
| 数据驻留 | 部署在自家基础设施,规则自己定 | 厂商云端 | 厂商云端 |
| 厂商绑定 | 无 | 完全绑定 | 完全绑定 |
🚀 快速开始
在本地机器下载并部署 Dograh
提示
我们会收集匿名使用数据以改进产品。如需关闭,请在下面的命令中将 ENABLE_TELEMETRY 设为 false。
提示
如果希望在远程服务器上运行该平台,请参考文档。
bash
curl -o docker-compose.yaml https://raw.githubusercontent.com/dograh-hq/dograh/main/docker-compose.yaml && REGISTRY=ghcr.io/dograh-hq ENABLE_TELEMETRY=true docker compose up --pull always
⚡ 想让 AI 智能体帮你完成部署?
如果你使用 Claude Code 或 Codex,可以安装官方的 Dograh 部署技能(skill),让智能体替你完成安装、配置与排障——它会识别你的操作系统、选择合适的部署方式、运行 Dograh 自带的部署脚本并验证结果。
text
在 Claude Code 中
/plugin marketplace add dograh-hq/dograh-plugins
/plugin install dograh@dograh
然后开启一个新会话,让它 _"set up Dograh"_(或运行 /dograh-setup)。Codex 同样支持——详见插件仓库。
提示
首次启动需要 2-3 分钟拉取所有镜像。启动完成后,打开 http://localhost:3010 即可创建你的第一个 AI 语音助手!
常见问题及解决方案请参见 🔧 故障排查。
🎙️ 你的第一个语音机器人
1. 在浏览器中打开 http://localhost:3010。
2. 选择 Inbound(呼入) 或 Outbound(外呼),为机器人命名(例如 _销售线索筛选_),再用 5-10 个词描述用途(例如 _筛选保险表单中的购买意向_)。
3. 点击 Test Agent。
4. 使用 Test Audio 在浏览器中和智能体语音对话,或使用 Test Chat 通过文本快速迭代。在 Test Chat 中,你可以编辑或重放用户消息,Dograh 会从该位置重新生成智能体回复和节点流转。
🔑 无需 API Key。 Dograh 自带一套自动生成的密钥,以及内置的 LLM / TTS / STT 栈。你可以随时接入自己的 LLM、TTS、STT 或电信服务商(如 Twilio、Vonage、Telnyx)。
使用 MCP 构建智能体
Dograh 内置 MCP 服务器,因此编码智能体可以直接在你的 Dograh 工作区中操作。
连接 Codex、Claude Code、Cursor 或任何 MCP 客户端后,可以查看现有智能体、搜索 Dograh 文档、获取节点 schema、创建新工作流,并通过自然语言保存草稿修改。
让编码智能体构建语音智能体时,请分享一份面向该用例的简短脚本,而不是只给一行提示。脚本最好包含智能体 persona、通话流程、规则、异议处理、成功标准,以及可选的示例对话。
请参见 MCP 指南 来连接你的助手。
功能特性
语音智能体构建器
- 可视化工作流构建器,支持 start 节点、agent 节点、全局指令、工具、跳转和结束通话结果
- Test Agent 面板内置 Test Audio 用于浏览器语音测试,并提供 Test Chat 用于快速提示词迭代
- 面向生产工作流的 QA 节点、知识库、webhook、嵌入和工具调用
语音与电信
- 内置 Twilio、Vonage、Telnyx、Plivo、Vobiz、Cloudonix 和 Asterisk ARI 等电信集成
- 在支持的电信服务商上,可通过通话转接实现人工接管
- 可接入自己的 LLM、TTS、STT 和电信服务商;通话产物可存储在内置 MinIO 或 AWS / S3 兼容存储中
开发者体验
- 一条命令即可完成自托管 Docker 部署
- Python 后端和模块化 provider 架构,便于定制
- Python 和 Node SDK,用于以编程方式创建智能体并发起外呼
部署方式
本地开发
参见Top issues
#635[Bug]: KB vector search recall silently collapses on small corpora — ivfflat index built on empty table + default probes=15 comments · 2026-08-09#811[Bug]: Self-hosted Web Call disconnects after ICE succeeds and data channel/audio transport fail3 comments · 2026-09-24#766[Bug]: Transcriber client crashes on null text field and doesn't recover from a stale pooled connection to the STT backend3 comments · 2026-09-13#561[Docs]: Agent becomes silent after caller provides mobile number3 comments · 2026-07-19#830[Bug]: Inbound Twilio calls fail signature validation when the number is processed in a non-US1 Twilio Region (ie1)2 comments · 2026-09-30#687[Feature]: Expose Gemini Live VAD params (GeminiVADParams) for google_vertex_realtime — short utterances go unanswered for 10-20s2 comments · 2026-08-23#641[Bug]: Agent not moving to next node even if conditions are met. [Extraction variables + prompt not enforcing move]2 comments · 2026-08-10#634[Bug]: Knowledge base .txt ingestion mangles Japanese text (dakuten stripped, kanji dropped); identical content via .docx is intact2 comments · 2026-08-09
Discussions
#997[Feature]: Add Gnani AI Prisma v2.5/v3.0 as a Streaming STT Provider0 comments · 2026-11-16#984Warm transfer: brief the person taking the call before the caller joins1 comments · 2026-11-08#980Languages0 comments · 2026-11-07#979More Languages0 comments · 2026-11-07#971How much does Smart Turn lose on phone audio?0 comments · 2026-11-04#956Feature request: i18n support for the dashboard UI0 comments · 2026-10-29#889Registry pattern for realtime service dispatch in service_factory.py?0 comments · 2026-10-12#881Sponsorship and model API ecosystem inquiry from 88API1 comments · 2026-10-12
Latest release
dograh: v1.51.0 dograh-v1.51.0 2026-11-041.51.0 (2026-11-04) What's Changed Features feat(tts): add Murf as a BYOK voice provider by @gaurav-murf in https://github.com/dograh-hq/dograh/pull/681 Bug Fixes fix: bump tuner-pipecat-sdk to 0.3.0 to keep all spoken agent lines by @HamzaFouad in https://github.com/dograh-hq/dograh/pull/968 New Contributors @gaurav-murf made their first contribution in https://github.com/dograh-hq/dograh/pull/681 Full Changelog: https://github.com/dograh-hq/dograh/compare/dograh-v1.50.0...dograh-v1.51.0 --- 🚀 Deployed to Production: https://dograh-jt2gy87m4-dograh-6922fbc1.vercel.app