项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
技术标签
使用教程
—
⚠ 该项目 README 未提供完整安装说明,以下步骤为通用流程,请以官方文档为准。
环境要求
- Python 环境(README 未标注具体版本,请以仓库文档为准)
- 可用的电话线路或电话号码(用于接入真实通话)
- 自备 AI 模型 / ASR / TTS 服务密钥(项目为 bring your own keys)
- 支持 MCP 的客户端或调用方
安装与启动步骤
-
1克隆仓库
把 Tel-Agent 源码拉到本地,确保 git 已安装并能访问 GitHub。
git clone https://github.com/Dpro-at/Tel-Agent.git -
2进入项目目录
切换到刚克隆下来的目录,后续命令都在此目录内执行。
cd Tel-Agent -
3生成配置文件
从示例文件复制出真正的 .env,不要直接改 .env.example,方便后续升级对照。
cp .env.example .env -
4填写密钥
按 .env.example 中的条目填入自己的模型与电话线路密钥;README 未列出具体键名,请对照示例文件逐项填写。
关键配置
| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
.env | 是 | 由 .env.example 复制而来,存放模型与电话线路等自有密钥 | .env |
如何确认成功
README 节选未给出启动成功后的验证方式,请参考仓库后续文档或日志输出自行确认。
常见问题
Q:需要安装哪些 Python 依赖?
A:README 节选未给出依赖安装命令,请查看仓库根目录下的依赖清单文件或后续文档说明。
Q:必须自己有电话线路吗?
A:项目定位是把任意电话线路接到任意 AI 模型,README 明确为自托管并自带密钥,因此需要自备线路资源。
Q:密钥要填在哪里?
A:填写在由 .env.example 复制得到的 .env 文件中,不要在示例文件里填写。
Q:支持接入哪些模型?
A:README 强调可接入任意 AI 模型并通过 MCP 连接,具体清单见仓库文档与品牌资源目录。
注意事项
- .env 中含密钥,切勿提交到 Git 仓库或公开分享。
- README 节选只有 Quick start 的克隆与复制配置两步,启动命令请以仓库最新文档为准。
- 项目标注 good-first-issue、hacktoberfest 等标签,遇到问题可先检索对应 issue。
- 本教程严格依据 README 节选整理,未出现的命令一律没有补充,避免误导。
核心亮点
- 把电话线路控制、语音识别、对话决策和语音合成串成完整链路,开发者不用自己拼电话协议
- 采用智能体加技能扩展的结构,新增业务能力只需写技能,不必改动核心通话流程
- 标注了 good-first-issue、hacktoberfest、help-wanted,对想参与开源的新人比较友好
不足之处
- 电话网关和语音服务依赖外部供应商,实际部署需要自行准备线路和密钥,开箱即用程度有限
- 项目处于成长阶段,文档和社区规模还在积累,复杂场景的稳定性有待验证
适用场景
- 中小企业搭建自动客服热线,接听常见问题并记录客户信息
- 预约类业务用 AI 外呼确认时间,减少人工重复拨号
- 语音通知场景中自动拨打电话并播报提醒内容
替代项目
Rasa、Vocode、Pipecat
同类项目推荐
xinchao-dynamic-mind
开源
给 AI 装上疲惫和欲望,让交互更真实
独立、可自托管的 AI 动态心智状态引擎:驱动力、念头池、疲惫、睡眠与意图。
goutoujunshi
开源
先哄情绪再出招,恋爱难题给可执行方案
一个先接住情绪、再分析关系并给出可执行策略的 Codex 恋爱军师,内置心理、法律、社会、人···
geo-sleuth
开源
给 AI 装上地理侦探技能,一张照片顺藤摸瓜找到拍摄地
An agent skill that finds where a photo was taken — OpenStreetMap geometry, elevati···
deepseek-harness
开源
把 AI 能力拆成乐高积木,拼出你的专属智能体。
DeepSeek Harness: Everything is a Plugin.
