MCPcopy
hub / github.com/dograh-hq/dograh

github.com/dograh-hq/dograh @dograh-v1.40.0 sqlite

repository ↗ · DeepWiki ↗ · release dograh-v1.40.0 ↗
5,898 symbols 23,386 edges 934 files 2,106 documented · 36%
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 替代方案 —— 通过拖拽式工作流编辑器构建生产级语音智能体,2 分钟内即可上线一个能用的语音机器人。

体验云端版本   60 秒自托管   加入 Slack

📖 文档  ·  📜 BSD 2-Clause  ·  🌐 English  ·  🌐 日本語

Dograh 实战演示 —— 搭建工作流、启动语音智能体、直接对话

  • 100% 开源,可自托管 —— 不像 Vapi 或 Retell,没有任何厂商绑定
  • 完全可控且透明 —— 每一行代码都是开放的,LLM / TTS / STT 集成灵活可换
  • 由 YC 校友与连续创业者维护,致力于让语音 AI 始终保持开放

🎥 媒体推荐

Better Stack 介绍 Dograh

Better Stack 上手实测 —— 深入体验 Dograh

📺 想看 2 分钟产品快速演示?点这里。

观看 Dograh AI 演示视频

⚖️ 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

提示 如果希望在远程服务器上运行该平台,请参考文档

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 CodeCodex,可以安装官方的 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. 点击 Web Call,直接和你的机器人对话。

🔑 无需 API Key。 Dograh 自带一套自动生成的密钥,以及内置的 LLM / TTS / STT 栈。你可以随时接入自己的 LLM、TTS、STT 或电信服务商(如 Twilio、Vonage、Telnyx)。

功能特性

语音能力

  • 电信集成:内置 Twilio、Vonage、Vobiz、Cloudonix 等(其他厂商也易于扩展),支持转接到人工坐席
  • 语言:支持英语(可扩展到其他语言)
  • 自定义模型:可接入自己的 TTS / STT 模型
  • 实时处理:低延迟语音交互

开发者体验

  • 零配置启动:自动生成 API Key,即开即用
  • 基于 Python:基于 Python 构建,便于二次开发
  • Docker 优先:容器化部署,环境一致
  • 模块化架构:按需替换各个组件

测试与质量

  • 测试模式:在发布前端到端试跑你的智能体,既不会产生真实通话,也不会影响生产数据
  • 面板内 Web 通话:在搭建过程中直接和机器人对话,无需配置任何电信服务
  • QA 节点:内置的工作流节点,可分析其他节点中提示词的质量

部署方式

本地开发

参见本地部署

自托管部署

如需了解远程服务器部署及 HTTPS 配置的详细步骤,请参见我们的 Docker 部署指南

云端版本

托管云版本请访问 https://www.dograh.com

📚 文档

完整文档请访问 https://docs.dograh.com

🤝 社区与支持

👋 从 Better Stack 视频过来的朋友? 欢迎在我们置顶的 GitHub Discussion 里留下你的使用场景 —— 每一条留言我们都会看,创始团队会亲自对接早期用户。

  • Slack —— Dograh AI 协作的主阵地。在这里和维护者交流、在动手前讨论功能、获取部署帮助,并跟进每一轮贡献活动。
  • GitHub Discussions —— 分享使用场景、提问、交流工作流配方。
  • GitHub Issues —— 报告 bug 或提交功能请求。

👉 加入我们 → Dograh 社区 Slack

🙌 参与贡献

我们欢迎一切贡献!Dograh AI 100% 开源,也会一直保持下去。

入门步骤

  • Fork 本仓库
  • 创建特性分支(git checkout -b feature/AmazingFeature)
  • 提交你的改动(git commit -m 'Add some AmazingFeature')
  • 推送到该分支(git push origin feature/AmazingFeature)
  • 提交一个 Pull Request

⭐ Star 历史

Dograh 的 Star 历史

📄 许可协议

Dograh AI 基于 BSD 2-Clause 协议开源 —— 与构建 Dograh AI 时所采用的项目使用相同的协议,确保兼容性,以及自由使用、修改和分发的权利。

🏢 关于我们

Dograh(Zansat Technologies Private Limited)用 ❤️ 打造。 创始团队由 YC 校友与连续创业者组成,致力于让语音 AI 始终开放、人人可用。

<a href="https://github.com/dograh-hq/dograh/stargazers">⭐ 给我们一个 Star</a> |
<a href="https://app.dograh.com">☁️ 试用云端版本</a> |
<a href="https://join.slack.com/t/dograh-community/shared_invite/zt-3zjb5vwvl-j7hRz3_F1SOn5cH~jm5f5g">💬 加入 Slack</a>

Extension points exported contracts — how you extend this code

SpecProvider (Interface)
(no doc) [2 implementers]
sdk/typescript/src/workflow.ts
GenerateRequest (Interface)
(no doc)
api/mcp_server/ts_validator/src/index.ts
CapturedEvent (Interface)
(no doc)
evals/visualizer/src/types/index.ts
Config (Interface)
(no doc)
ui/src/client/client/types.gen.ts
DograhFetchInit (Interface)
(no doc)
sdk/typescript/src/client.ts
ParseRequest (Interface)
(no doc)
api/mcp_server/ts_validator/src/index.ts
EventCaptureResult (Interface)
(no doc)
evals/visualizer/src/types/index.ts
RequestOptions (Interface)
(no doc)
ui/src/client/client/types.gen.ts

Core symbols most depended-on inside this repo

append
called by 344
api/services/pipecat/in_memory_buffers.py
cn
called by 207
ui/src/lib/utils.ts
json
called by 149
sdk/typescript/src/client.ts
text
called by 126
sdk/typescript/src/client.ts
add
called by 104
sdk/typescript/src/workflow.ts
onChange
called by 71
ui/src/hooks/use-mobile.ts
close
called by 58
api/services/campaign/rate_limiter.py
spec_field
called by 56
api/services/workflow/node_specs/model_spec.py

Shape

Function 3,035
Method 1,642
Class 759
Interface 284
Route 177
Enum 1

Languages

Python74%
TypeScript26%

Modules by API surface

ui/src/client/sdk.gen.ts163 symbols
api/routes/organization.py85 symbols
api/services/configuration/registry.py68 symbols
api/routes/workflow.py68 symbols
api/tests/test_custom_tools.py58 symbols
api/routes/campaign.py51 symbols
sdk/python/src/dograh_sdk/_generated_models.py50 symbols
api/tests/test_resolve_effective_config.py45 symbols
api/services/workflow/pipecat_engine.py42 symbols
api/services/telephony/ari_manager.py42 symbols
api/services/workflow/dto.py40 symbols
api/tests/test_json_parser.py39 symbols

Dependencies from manifests, versioned

@calcom/embed-react1.5.3 · 1×
@dagrejs/dagre1.1.4 · 1×
@dograh/sdklatest · 1×
@eslint/eslintrc3 · 1×
@hey-api/openapi-ts0.99.0 · 1×
@radix-ui/react-alert-dialog1.1.15 · 1×
@radix-ui/react-checkbox1.3.2 · 1×
@radix-ui/react-collapsible1.1.12 · 1×
@radix-ui/react-dialog1.1.15 · 1×
@radix-ui/react-dropdown-menu2.1.7 · 1×
@radix-ui/react-label2.1.3 · 1×
@radix-ui/react-popover1.1.14 · 1×

For agents

$ claude mcp add dograh \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact