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.

📚 摘要

Dograh AI 是一个 开源、可自托管的平台，用于构建语音 AI 代理。它让您可以透过可视化工作流编辑器来创建、测试和运行基于电话的对话机器人。该堆栈是模块化的——您可以插入任何 LLM、语音转文字 (STT)、文字转语音 (TTS) 或电话服务提供商，也可以使用产品随附的堆栈。一键式 Docker 安装可在几分钟内运行完整实例，同时也提供云端托管的 SaaS 版本。

🛠️ 核心功能

功能	描述
可视化工作流构建器	拖放节点（开始、代理、工具、QA、知识库、webhooks、结束）以设计通话流程，无需编码。
测试面板	Test Audio 让您在浏览器中与机器人对话；Test Chat 实现快速的文字迭代和对话轮次重播。
电话集成	内建 Twilio、Vonage、Telnyx、Plivo、Vobiz、Cloudonix、Asterisk ARI 的连接器，并支持通过通话转接进行人工接手。
可插拔 AI 堆栈	引入您自己的 LLM、STT、TTS，或使用 Dograh 的默认堆栈；密钥可通过环境变量配置。
MCP (Machine Coding Protocol) 支持	连接 Claude Code、Codex、Cursor 或任何 MCP 客户端，以程序化方式编辑工作流、获取架构并从自然语言提示生成代理。
SDKs	Python (`dograh-sdk`) 和 Node (`@dograh/sdk`) 函数库，用于程序化创建代理和拨打外拨电话。
一键式 Docker 部署	`curl … && ./start_docker.sh` 拉取 `docker‑compose.yaml` 并启动整个堆栈（API、UI、MinIO 存储、可选的 Cloudflare tunnel）。
自托管数据	所有数据均位于您的基础设施上（MinIO 或兼容 S3 的存储），提供完整的数据驻留控制。

🚀 入门指南 (快速开始)

# 获取 Docker compose 文件和启动脚本
curl -o docker-compose.yaml https://raw.githubusercontent.com/dograh-hq/dograh/main/docker-compose.yaml \
     -o start_docker.sh https://raw.githubusercontent.com/dograh-hq/dograh/main/scripts/start_docker.sh
chmod +x start_docker.sh
# 启动平台（为入站 webhooks 建立一个公开的 Cloudflare tunnel）
./start_docker.sh

几分钟后，即可在 http://localhost:3010 访问 UI。
创建账号，然后使用可视化构建器定义语音机器人。
使用内建的音频或聊天测试器立即进行测试。

📦 架构概览 (高阶)

前端 – React UI，服务于 3010 端口，提供工作流编辑器和测试工具。
后端 – Python 服务，处理 API 请求、协调 LLM 调用、STT/TTS 以及电话 webhook 路由。
存储 – MinIO（自托管 S3 兼容）或外部 S3，用于持久化录音、提示词和机器人定义。
电话网关 – 连接器将来自提供商的入站/出站通话事件转换为统一的内部格式。
MCP 服务器 – 公开一个端点，供编码助手（Claude Code、Codex 等）调用以读取/写入工作流 JSON。

🤝 社区与支持

Slack 社区 – 用于故障排除、功能讨论和入职的活跃频道。
GitHub Discussions & Issues – 用于分享用例、回报错误和提交 PR 的地方。
文档 – 完整文档请见 https://docs.dograh.com，涵盖部署、MCP 集成和 SDK 使用。

📜 授权

BSD 2‑Clause – 宽松授权，允许商业使用、修改和重新分发。

以上所有信息均直接取自仓库的 README；未添加任何外部假设。