目录
- 👋 开始使用 & 加入 TEN 社区
- ✨ 特性
- 💡 TEN Agent 用例
- 🧩 现成可用的扩展
- 🎮 TEN Agent Playground
- ↪️ TEN Agent Demo
- 🛳️ 自托管
- 🏗️ TEN Agent 架构
- 🌍 TEN Framework 生态系统
- 🤝 贡献
TEN Agent 是一个由 TEN 提供支持的会话式语音 AI 代理,集成了 DeepSeek、Gemini、OpenAI、RTC 和 ESP32 等硬件设备。它支持实时 AI 功能,如视觉、听觉和语音,并与 Dify 和 Coze 等平台完全兼容。
| 社区渠道 | 用途 |
|---|---|
| 加入我们的 Discord 社区,与开发者交流,分享项目并获取帮助 | |
| 在 X 上关注 TEN Framework 获取最新信息和公告 | |
| 加入我们的微信群组参与中文社区讨论 |
Important
为我们的仓库加星 ⭐️
获取新版本和更新的即时通知。您的支持有助于我们发展和改进 TEN Agent!
星标历史
使用 Trulience 的多样化免费头像选项,通过 TEN Agent 构建引人入胜的 AI 头像。要启动并运行,只需两个步骤:
TEN Agent + Trulience
TEN 是一个非常多功能的框架。也就是说,TEN Agent 兼容 DeepSeek R1,尝试体验与 DeepSeek R1 的实时对话!
TEN Agent 现在运行在 Espressif ESP32-S3 Korvo V3 开发板上,这是将实时通信与 LLM 集成到硬件中的绝佳方式。
尝试 Google Gemini 多模态实时 API,具有 实时视觉 和 实时屏幕共享检测 功能,它是一个现成的扩展,配备了强大的工具,如 天气检查 和 网络搜索,完美集成到 TEN Agent 中。
Gemini 2.0 多模态实时 API

描述一个主题并让 TEN Agent 给你讲一个故事,同时生成故事的图像,为孩子们提供更身临其境的体验。
故事讲述者 + 图像生成器

TEN 提供了极好的支持,使实时互动体验在其他 LLM 平台上也变得更好,查看文档了解更多。
TEN Agent + Dify with RAG

TEN 提供了极好的支持,使实时互动体验在其他 LLM 平台上也变得更好,查看文档了解更多。
| 类别 | 要求 |
|---|---|
| 密钥 | • 声网 APP ID 和 APP 证书(每月免费分钟数) • OpenAI API 密钥(任何兼容 OpenAI 的 LLM) • Deepgram ASR(注册可获得免费积分) • Elevenlabs TTS(注册可获得免费积分) |
| 安装 | • Docker / Docker Compose • Node.js(LTS) v18 |
| 最低系统要求 | • CPU >= 2 核 • 内存 >= 4 GB |
Note
macOS: Apple Silicon 上的 Docker 设置
在 Docker 设置中取消选中"使用 Rosetta 进行 x86/amd64 仿真",可能会导致 ARM 上的构建时间较慢,但在部署到 x64 服务器时性能将正常。
如果在国内,我们强烈建议在 SSH 中把代理打开,下载和安装的依赖的时候会更加丝滑。
# 如果用的代理软件没有增强模式的话, 建议手动把所有代理协议都打开
# export 的有效期为一个 session
export https_proxy=http://127.0.0.1:<port>
export http_proxy=http://127.0.0.1:<port>
export all_proxy=socks5://127.0.0.1:<port>
# Docker
export https_proxy=http://host.docker.internal:<port>
export http_proxy=http://host.docker.internal:<port>
export all_proxy=http://host.docker.internal:<port>
# tman 镜像设置
mkdir -p ~/.tman && echo '{
"registry": {
"default": {
"index": "https://registry-ten.rtcdeveloper.cn/api/ten-cloud-store/v1/packages"
}
}
}' > ~/.tman/config.json
# GO 代理设置
export GOPROXY=https://goproxy.cn,direct
# pip 代理设置, 此设置需要先安装 pip
pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple
export UV_INDEX_URL=https://pypi.tuna.tsinghua.edu.cn/simplecp ./.env.example ./.envAGORA_APP_ID=
AGORA_APP_CERTIFICATE=docker compose up -ddocker exec -it ten_agent_dev bash查看 /examples 文件夹获取更多示例
task usetask run- 打开 localhost:3000 并选择一个图示例
- 选择对应的模块
- 选择一个扩展并配置其 API 密钥和设置
模块选择器示例

现在,我们已经成功设置了 Playground。这只是 TEN Agent 的开始。还有许多不同的方式可以探索和利用 TEN Agent。要了解更多,请参阅 文档。
GitHub 为每个仓库提供免费的 Codespace,您可以在 Codespace 中运行 Playground 而无需使用 Docker。此外,Codespace 的速度比本地主机快得多。
查看 此指南 了解更多详情。
Playground 和 Demo 服务于不同的目的,简而言之,可以将 Playground 视为自定义代理的工具,而 Demo 则是部署代理的工具。
查看 此指南 了解更多详情。
一旦您定制了您的代理(无论是通过使用 Playground 还是直接编辑 property.json),您可以通过为您的服务创建发布 Docker 镜像来部署它。
阅读 部署指南 以获取有关部署的详细信息。
即将推出...
| 🏚️ TEN Framework TEN,一个支持实时对话的 AI 代理框架,用于创建各种 AI 代理。 |
![]() |
|---|---|
| 🎙️ TEN Agent TEN Agent 是一个由 TEN 提供支持的会话式语音 AI 代理,集成了 Deepseek、Gemini、OpenAI、RTC 和 ESP32 等硬件设备。它支持实时 AI 功能,如视觉、听觉和语音,并与 Dify 和 Coze 等平台完全兼容。 |
![]() |
🎨 TMAN Designer alphaTMAN Designer 是一个低/无代码选项,用于制作酷炫的语音代理。凭借其易于使用的工作流 UI,您可以轻松构建各种功能。它带有运行时、暗/亮主题、集成编辑器和集成终端。 |
![]() |
| 📒 TEN Portal TEN 框架的官方网站,包含文档、博客和展示内容。 |
![]() |
我们欢迎各种形式的开源协作!无论您是修复错误、添加功能、改进文档还是分享想法 - 您的贡献都有助于推进个性化 AI 工具的发展。查看我们的 GitHub Issues 和 Projects,寻找贡献方式并展示您的技能。让我们一起构建令人惊叹的东西!🤝✨
欢迎贡献!请先阅读 贡献指南。
本项目采用 Apache 2.0 许可证。









