TEN-framework/ten-framework

![Image][ten-framework-banner]

[![TEN Releases][ten-releases-badge]][ten-releases] [![Coverage Status][coverage-badge]][coverage] [![Release Date][release-date-badge]][ten-releases] [![Commits][commits-badge]][commit-activity] [![Issues closed][issues-closed-badge]][issues-closed] [![Contributors][contributors-badge]][contributors] [![GitHub license][license-badge]][license] [![Ask DeepWiki][deepwiki-badge]][deepwiki] [![ReadmeX][readmex-badge]][readmex]

[![README in English][lang-en-badge]][lang-en-readme] [![简体中文操作指南][lang-zh-badge]][lang-zh-readme] [![日本語のREADME][lang-jp-badge]][lang-jp-readme] [![README in 한국어][lang-kr-badge]][lang-kr-readme] [![README en Español][lang-es-badge]][lang-es-readme] [![README en Français][lang-fr-badge]][lang-fr-readme] [![README in Italiano][lang-it-badge]][lang-it-readme]

[![TEN-framework%2Ften_framework | Trendshift][trendshift-badge]][trendshift]

[Official Site][official-site] • [Documentation][documentation] • [Blog][blog]

目录

• [欢迎使用 TEN][welcome-to-ten]
• [智能体示例][agent-examples-section]
• [智能体示例快速入门][quick-start]
  • [本地运行][localhost-section]
  • [Codespaces][codespaces-section]
• [智能体示例自托管][agent-examples-self-hosting]
  • [使用 Docker 部署][deploying-with-docker]
  • [使用其他云服务部署][deploying-with-other-cloud-services]
• [保持关注][stay-tuned]
• [TEN 生态系统][ten-ecosystem-anchor]
• [问题咨询][questions]
• [贡献指南][contributing]
  • [代码贡献者][code-contributors]
  • [贡献准则][contribution-guidelines]
  • [许可协议][license-section]

欢迎使用 TEN

TEN 是一个用于实时多模态对话式 AI 的开源框架。

[TEN 生态系统][ten-ecosystem-anchor]包括 [TEN Framework][ten-framework]、[智能体示例 (Agent Examples)][agent-examples-repo]、[VAD][ten-vad]、[Turn Detection (轮次检测)][ten-turn-detection] 以及 [Portal][ten-portal]。

社区频道	用途
[![Follow on X][follow-on-x-badge]][follow-on-x]	在 X 上关注 TEN Framework 获取更新和公告
[![Discord TEN Community][discord-badge]][discord-invite]	加入我们的 Discord 社区与开发者交流
[![Follow on LinkedIn][linkedin-badge]][linkedin]	在 LinkedIn 上关注 TEN Framework 获取更新和公告
[![Hugging Face Space][hugging-face-badge]][hugging-face]	加入我们的 Hugging Face 社区探索空间和模型
[![WeChat][wechat-badge]][wechat-discussion]	加入我们的微信群进行中文社区讨论

智能体示例

![Image][voice-assistant-image]

多用途语音助手 — 这是一个低延迟、高质量的实时助手，支持 RTC 和 [WebSocket][websocket-example] 连接。你可以通过 [Memory][memory-example]、[VAD][voice-assistant-vad-example]、[Turn Detection][voice-assistant-turn-detection-example] 等扩展来增强其功能。

更多详情请参考 [示例代码][voice-assistant-example]。

![divider][divider-light] ![divider][divider-dark]

![Image][doodler-image]

Doodler — 一个涂鸦画板，可将语音或文本提示转化为简单的手绘草图，配备蜡笔调色板和实时绘制功能。

[示例代码][doodler-example]

![divider][divider-light] ![divider][divider-dark]

![Image][speaker-diarization-image]

说话人日志 (Speaker Diarization) — 实时说话人日志功能，可检测并标记不同的说话人。“谁喜欢什么 (Who Likes What)”游戏展示了一个交互式用例。

[示例代码][speechmatics-diarization-example]

![divider][divider-light] ![divider][divider-dark]

![Image][lip-sync-image]

唇形同步虚拟形象 (Lip Sync Avatars) — 可与多个虚拟形象供应商协同工作。主要角色包括使用 MotionSync 驱动唇形同步的动漫角色 Kei，同时也支持来自 Trulience、HeyGen 和 Tavus 的逼真虚拟形象。

查看 [示例代码][voice-assistant-live2d-example] 以获取不同 Live2D 角色的实现。

![divider][divider-light] ![divider][divider-dark]

![Image][sip-call-image]

SIP 通话 — 支持由 TEN 驱动的电话呼叫的 SIP 扩展。

[示例代码][voice-assistant-sip-example]

![divider][divider-light] ![divider][divider-dark]

![Image][transcription-image]

转录 (Transcription) — 一种将音频转换为文本的转录工具。

[示例代码][transcription-example]

![divider][divider-light] ![divider][divider-dark]

![Image][esp32-image]

ESP32-S3 Korvo V3 — 在 Espressif ESP32-S3 Korvo V3 开发板上运行 TEN 智能体示例，实现由 LLM 驱动的硬件通信集成。

更多详情请参考 [集成指南][esp32-guide]。

[![][back-to-top]][readme-top]

智能体示例快速入门

本地运行

第一步 - 前置要求

分类	要求
密钥	• Agora [App ID][agora-app-id] 和 [App Certificate][agora-app-certificate] • [OpenAI][openai-api] API key • [Deepgram][deepgram] ASR • [ElevenLabs][elevenlabs] TTS
安装	...