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開源協議。