Skip to content

Latest commit

 

History

History
503 lines (309 loc) · 20.6 KB

README-CN.md

File metadata and controls

503 lines (309 loc) · 20.6 KB

TEN Agent 横幅

在 X 上关注 讨论帖子 提交活动 已关闭的问题 欢迎 PR GitHub 许可证

Discord TEN 社区

GitHub 关注者 GitHub 分叉 GitHub 星标

README in English 简体中文操作指南 日本語のREADME README in 한국어 README en Español README en Français README in Italiano

文档   •   快速开始   •   TEN 框架仓库

TEN-framework%2FTEN-Agent | Trendshift


目录

目录


👋 开始使用 & 加入 TEN 社区

TEN Agent 是一个由 TEN 提供支持的会话式语音 AI 代理,集成了 DeepSeek、Gemini、OpenAI、RTC 和 ESP32 等硬件设备。它支持实时 AI 功能,如视觉、听觉和语音,并与 Dify 和 Coze 等平台完全兼容。


社区渠道 用途
Discord TEN 社区 加入我们的 Discord 社区,与开发者交流,分享项目并获取帮助
在 X 上关注 在 X 上关注 TEN Framework 获取最新信息和公告
微信 加入我们的微信群组参与中文社区讨论

Important

为我们的仓库加星 ⭐️

获取新版本和更新的即时通知。您的支持有助于我们发展和改进 TEN Agent!


TEN star us gif

星标历史


✨ 特性

1️⃣ 🔥 Ten Agent + Trulience

使用 Trulience 的多样化免费头像选项,通过 TEN Agent 构建引人入胜的 AI 头像。要启动并运行,只需两个步骤:

  1. 按照 README 完成设置并在 localhost:3000 运行 Playground
  2. 输入从 Trulience 获取的头像 ID 和 令牌
TEN Agent + Trulience

TEN Agent with Trulience

TEN 是一个非常多功能的框架。也就是说,TEN Agent 兼容 DeepSeek R1,尝试体验与 DeepSeek R1 的实时对话!

TEN Agent 现在运行在 Espressif ESP32-S3 Korvo V3 开发板上,这是将实时通信与 LLM 集成到硬件中的绝佳方式。

4️⃣ TEN Agent + Gemini 多模态实时 API

尝试 Google Gemini 多模态实时 API,具有 实时视觉 和 实时屏幕共享检测 功能,它是一个现成的扩展,配备了强大的工具,如 天气检查 和 网络搜索,完美集成到 TEN Agent 中。

Gemini 2.0 多模态实时 API

用例

5️⃣ TEN Agent + 故事讲述者 + 图像生成器

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

故事讲述者 + 图像生成器

用例

6️⃣ TEN Agent + Dify

TEN Agent + Dify

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

TEN Agent + Dify with RAG

Dify with RAG

7️⃣ TEN Agent + Coze

TEN Agent + Coze

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


💡 TEN Agent 用例

用例


🧩 现成可用的扩展

现成的扩展


🎮 TEN Agent Playground

🅰️ 在 localhost 运行 Playground

步骤 ⓵ - 先决条件

类别 要求
密钥 • 声网 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

步骤 ⓶ - 在虚拟机中构建代理

1. 克隆仓库并从 .env.example 创建 .env 文件
cp ./.env.example ./.env
2. 在 .env 中设置 Agora App ID 和 App 证书
AGORA_APP_ID=
AGORA_APP_CERTIFICATE=
3. 启动代理开发容器
docker compose up -d
4. 进入容器
docker exec -it ten_agent_dev bash
5. 使用默认的 graph 构建代理 (约 5-8 分钟)

查看 /examples 文件夹获取更多示例

task use
6. 启动 Web 服务器
task run

步骤 ⓷ - 自定义您的代理

  1. 打开 localhost:3000 并选择一个图示例
  2. 选择对应的模块
  3. 选择一个扩展并配置其 API 密钥和设置
模块选择器示例

模块选择器示例

现在,我们已经成功设置了 Playground。这只是 TEN Agent 的开始。还有许多不同的方式可以探索和利用 TEN Agent。要了解更多,请参阅 文档。


🅱️ 在 Codespace 运行 Playground(无需 docker)

GitHub 为每个仓库提供免费的 Codespace,您可以在 Codespace 中运行 Playground 而无需使用 Docker。此外,Codespace 的速度比本地主机快得多。

查看 此指南 了解更多详情。


↪️ TEN Agent Demo

Playground 和 Demo 服务于不同的目的,简而言之,可以将 Playground 视为自定义代理的工具,而 Demo 则是部署代理的工具。

查看 此指南 了解更多详情。


🛳️ 自托管

🅰️ 使用 Docker 部署

一旦您定制了您的代理(无论是通过使用 Playground 还是直接编辑 property.json),您可以通过为您的服务创建发布 Docker 镜像来部署它。

阅读 部署指南 以获取有关部署的详细信息。


🅱️ 使用其他服务部署

即将推出...


🏗️ TEN Agent 架构

组件图


🌍 TEN Framework 生态系统

🏚️ TEN Framework
TEN,一个支持实时对话的 AI 代理框架,用于创建各种 AI 代理。

🎙️ TEN Agent
TEN Agent 是一个由 TEN 提供支持的会话式语音 AI 代理,集成了 Deepseek、Gemini、OpenAI、RTC 和 ESP32 等硬件设备。它支持实时 AI 功能,如视觉、听觉和语音,并与 Dify 和 Coze 等平台完全兼容。

🎨 TMAN Designer alpha
TMAN Designer 是一个低/无代码选项,用于制作酷炫的语音代理。凭借其易于使用的工作流 UI,您可以轻松构建各种功能。它带有运行时、暗/亮主题、集成编辑器和集成终端。

📒 TEN Portal
TEN 框架的官方网站,包含文档、博客和展示内容。


🤝 贡献

我们欢迎各种形式的开源协作!无论您是修复错误、添加功能、改进文档还是分享想法 - 您的贡献都有助于推进个性化 AI 工具的发展。查看我们的 GitHub Issues 和 Projects,寻找贡献方式并展示您的技能。让我们一起构建令人惊叹的东西!🤝✨

代码贡献者

TEN

贡献指南

欢迎贡献!请先阅读 贡献指南。

许可证

本项目采用 Apache 2.0 许可证。