Ten Agent

🚀 TEN代理组件

TEN代理是一个集成多种AI技术的实时语音助手平台，支持多模态交互和模块化扩展，为用户提供高效、智能的语音交互体验。

🚀 快速开始

TEN代理组件集成多种AI技术，支持多模态交互与模块化扩展。下面将为你介绍其核心功能、项目架构、安装步骤、使用方法等内容。

✨ 主要特性

• 实时语音处理：基于Deepgram的ASR和FishAudio的TTS实现语音交互。
• AI推理能力：整合OpenAI API进行智能对话。
• 实时音视频：利用Agora.io构建实时通讯能力。
• 扩展插件支持：模块化设计，便于功能扩展。

项目架构

📦 安装指南

系统要求

• 处理器：双核或更高
• 内存：4GB或以上
• 必备工具：
  • Docker容器运行时环境
  • Node.js LTS版本18.x

macOS配置注意事项

对于苹果芯片的Mac，进入Docker设置中取消勾选“使用Rosetta进行x86/AMD64仿真”。注意：这可能导致在ARM架构下的构建速度变慢，但部署到x64服务器后性能正常。

安装步骤

1. 创建.env文件

   cp ./.env.example ./.env
   

2. 配置Agora密钥 更新.env文件中的以下变量：

   AGORA_APP_ID=
   AGORA_APP_CERTIFICATE=
   

3. 启动开发容器

   docker compose up -d
   

4. 进入容器环境

   docker exec -it ten_agent_dev bash
   

5. 构建代理服务

   task use
   

6. 运行Web界面

   task run
   

7. 配置 Playground 打开地址：localhost:3000，选择所需模块和插件。

💻 使用示例

Gemini实时插件

1. 打开Playground界面。
2. 选择“voice_assistant_realtime”图。
3. 选中Gemini实时模块。
4. 添加v2v扩展并配置API密钥。

项目组件

📚 详细文档

加入社区

• Discord：链接
• GitHub仓库：链接

贡献指南

1. 代码规范：
   • 遵循ES6标准。
   • 使用2空格缩进。
2. 提交准则：
   • 提交信息需包含类型和作用。
   • 提供相关文档支持。

📄 许可证

本项目遵循MIT开源协议。