[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"similar-TEN-framework--ten-framework":3,"tool-TEN-framework--ten-framework":64},[4,17,27,35,43,56],{"id":5,"name":6,"github_repo":7,"description_zh":8,"stars":9,"difficulty_score":10,"last_commit_at":11,"category_tags":12,"status":16},3808,"stable-diffusion-webui","AUTOMATIC1111\u002Fstable-diffusion-webui","stable-diffusion-webui 是一个基于 Gradio 构建的网页版操作界面，旨在让用户能够轻松地在本地运行和使用强大的 Stable Diffusion 图像生成模型。它解决了原始模型依赖命令行、操作门槛高且功能分散的痛点，将复杂的 AI 绘图流程整合进一个直观易用的图形化平台。\n\n无论是希望快速上手的普通创作者、需要精细控制画面细节的设计师，还是想要深入探索模型潜力的开发者与研究人员，都能从中获益。其核心亮点在于极高的功能丰富度：不仅支持文生图、图生图、局部重绘（Inpainting）和外绘（Outpainting）等基础模式，还独创了注意力机制调整、提示词矩阵、负向提示词以及“高清修复”等高级功能。此外，它内置了 GFPGAN 和 CodeFormer 等人脸修复工具，支持多种神经网络放大算法，并允许用户通过插件系统无限扩展能力。即使是显存有限的设备，stable-diffusion-webui 也提供了相应的优化选项，让高质量的 AI 艺术创作变得触手可及。",162132,3,"2026-04-05T11:01:52",[13,14,15],"开发框架","图像","Agent","ready",{"id":18,"name":19,"github_repo":20,"description_zh":21,"stars":22,"difficulty_score":23,"last_commit_at":24,"category_tags":25,"status":16},1381,"everything-claude-code","affaan-m\u002Feverything-claude-code","everything-claude-code 是一套专为 AI 编程助手（如 Claude Code、Codex、Cursor 等）打造的高性能优化系统。它不仅仅是一组配置文件，而是一个经过长期实战打磨的完整框架，旨在解决 AI 代理在实际开发中面临的效率低下、记忆丢失、安全隐患及缺乏持续学习能力等核心痛点。\n\n通过引入技能模块化、直觉增强、记忆持久化机制以及内置的安全扫描功能，everything-claude-code 能显著提升 AI 在复杂任务中的表现，帮助开发者构建更稳定、更智能的生产级 AI 代理。其独特的“研究优先”开发理念和针对 Token 消耗的优化策略，使得模型响应更快、成本更低，同时有效防御潜在的攻击向量。\n\n这套工具特别适合软件开发者、AI 研究人员以及希望深度定制 AI 工作流的技术团队使用。无论您是在构建大型代码库，还是需要 AI 协助进行安全审计与自动化测试，everything-claude-code 都能提供强大的底层支持。作为一个曾荣获 Anthropic 黑客大奖的开源项目，它融合了多语言支持与丰富的实战钩子（hooks），让 AI 真正成长为懂上",138956,2,"2026-04-05T11:33:21",[13,15,26],"语言模型",{"id":28,"name":29,"github_repo":30,"description_zh":31,"stars":32,"difficulty_score":23,"last_commit_at":33,"category_tags":34,"status":16},2271,"ComfyUI","Comfy-Org\u002FComfyUI","ComfyUI 是一款功能强大且高度模块化的视觉 AI 引擎，专为设计和执行复杂的 Stable Diffusion 图像生成流程而打造。它摒弃了传统的代码编写模式，采用直观的节点式流程图界面，让用户通过连接不同的功能模块即可构建个性化的生成管线。\n\n这一设计巧妙解决了高级 AI 绘图工作流配置复杂、灵活性不足的痛点。用户无需具备编程背景，也能自由组合模型、调整参数并实时预览效果，轻松实现从基础文生图到多步骤高清修复等各类复杂任务。ComfyUI 拥有极佳的兼容性，不仅支持 Windows、macOS 和 Linux 全平台，还广泛适配 NVIDIA、AMD、Intel 及苹果 Silicon 等多种硬件架构，并率先支持 SDXL、Flux、SD3 等前沿模型。\n\n无论是希望深入探索算法潜力的研究人员和开发者，还是追求极致创作自由度的设计师与资深 AI 绘画爱好者，ComfyUI 都能提供强大的支持。其独特的模块化架构允许社区不断扩展新功能，使其成为当前最灵活、生态最丰富的开源扩散模型工具之一，帮助用户将创意高效转化为现实。",107662,"2026-04-03T11:11:01",[13,14,15],{"id":36,"name":37,"github_repo":38,"description_zh":39,"stars":40,"difficulty_score":23,"last_commit_at":41,"category_tags":42,"status":16},3704,"NextChat","ChatGPTNextWeb\u002FNextChat","NextChat 是一款轻量且极速的 AI 助手，旨在为用户提供流畅、跨平台的大模型交互体验。它完美解决了用户在多设备间切换时难以保持对话连续性，以及面对众多 AI 模型不知如何统一管理的痛点。无论是日常办公、学习辅助还是创意激发，NextChat 都能让用户随时随地通过网页、iOS、Android、Windows、MacOS 或 Linux 端无缝接入智能服务。\n\n这款工具非常适合普通用户、学生、职场人士以及需要私有化部署的企业团队使用。对于开发者而言，它也提供了便捷的自托管方案，支持一键部署到 Vercel 或 Zeabur 等平台。\n\nNextChat 的核心亮点在于其广泛的模型兼容性，原生支持 Claude、DeepSeek、GPT-4 及 Gemini Pro 等主流大模型，让用户在一个界面即可自由切换不同 AI 能力。此外，它还率先支持 MCP（Model Context Protocol）协议，增强了上下文处理能力。针对企业用户，NextChat 提供专业版解决方案，具备品牌定制、细粒度权限控制、内部知识库整合及安全审计等功能，满足公司对数据隐私和个性化管理的高标准要求。",87618,"2026-04-05T07:20:52",[13,26],{"id":44,"name":45,"github_repo":46,"description_zh":47,"stars":48,"difficulty_score":23,"last_commit_at":49,"category_tags":50,"status":16},2268,"ML-For-Beginners","microsoft\u002FML-For-Beginners","ML-For-Beginners 是由微软推出的一套系统化机器学习入门课程，旨在帮助零基础用户轻松掌握经典机器学习知识。这套课程将学习路径规划为 12 周，包含 26 节精炼课程和 52 道配套测验，内容涵盖从基础概念到实际应用的完整流程，有效解决了初学者面对庞大知识体系时无从下手、缺乏结构化指导的痛点。\n\n无论是希望转型的开发者、需要补充算法背景的研究人员，还是对人工智能充满好奇的普通爱好者，都能从中受益。课程不仅提供了清晰的理论讲解，还强调动手实践，让用户在循序渐进中建立扎实的技能基础。其独特的亮点在于强大的多语言支持，通过自动化机制提供了包括简体中文在内的 50 多种语言版本，极大地降低了全球不同背景用户的学习门槛。此外，项目采用开源协作模式，社区活跃且内容持续更新，确保学习者能获取前沿且准确的技术资讯。如果你正寻找一条清晰、友好且专业的机器学习入门之路，ML-For-Beginners 将是理想的起点。",84991,"2026-04-05T10:45:23",[14,51,52,53,15,54,26,13,55],"数据工具","视频","插件","其他","音频",{"id":57,"name":58,"github_repo":59,"description_zh":60,"stars":61,"difficulty_score":10,"last_commit_at":62,"category_tags":63,"status":16},3128,"ragflow","infiniflow\u002Fragflow","RAGFlow 是一款领先的开源检索增强生成（RAG）引擎，旨在为大语言模型构建更精准、可靠的上下文层。它巧妙地将前沿的 RAG 技术与智能体（Agent）能力相结合，不仅支持从各类文档中高效提取知识，还能让模型基于这些知识进行逻辑推理和任务执行。\n\n在大模型应用中，幻觉问题和知识滞后是常见痛点。RAGFlow 通过深度解析复杂文档结构（如表格、图表及混合排版），显著提升了信息检索的准确度，从而有效减少模型“胡编乱造”的现象，确保回答既有据可依又具备时效性。其内置的智能体机制更进一步，使系统不仅能回答问题，还能自主规划步骤解决复杂问题。\n\n这款工具特别适合开发者、企业技术团队以及 AI 研究人员使用。无论是希望快速搭建私有知识库问答系统，还是致力于探索大模型在垂直领域落地的创新者，都能从中受益。RAGFlow 提供了可视化的工作流编排界面和灵活的 API 接口，既降低了非算法背景用户的上手门槛，也满足了专业开发者对系统深度定制的需求。作为基于 Apache 2.0 协议开源的项目，它正成为连接通用大模型与行业专有知识之间的重要桥梁。",77062,"2026-04-04T04:44:48",[15,14,13,26,54],{"id":65,"github_repo":66,"name":67,"description_en":68,"description_zh":69,"ai_summary_zh":69,"readme_en":70,"readme_zh":71,"quickstart_zh":72,"use_case_zh":73,"hero_image_url":74,"owner_login":75,"owner_name":76,"owner_avatar_url":77,"owner_bio":78,"owner_company":79,"owner_location":79,"owner_email":79,"owner_twitter":79,"owner_website":79,"owner_url":80,"languages":81,"stars":121,"forks":122,"last_commit_at":123,"license":124,"difficulty_score":125,"env_os":126,"env_gpu":127,"env_ram":128,"env_deps":129,"category_tags":135,"github_topics":136,"view_count":142,"oss_zip_url":79,"oss_zip_packed_at":79,"status":16,"created_at":143,"updated_at":144,"faqs":145,"releases":146},2397,"TEN-framework\u002Ften-framework","ten-framework"," Open-source framework for conversational voice AI agents","ten-framework 是一个专为实时多模态对话式 AI 打造的开源框架，旨在帮助开发者轻松构建低延迟、高互动的语音智能体。它解决了传统语音交互开发中链路复杂、实时性差以及难以整合视觉等多模态能力的痛点，让创建如实时语音助手、语音绘图板或唇形同步虚拟人等应用变得简单高效。\n\n该工具主要面向 AI 工程师、后端开发者及研究人员，同时也适合希望快速原型验证的产品设计师。ten-framework 的核心亮点在于其模块化生态系统，不仅提供了基础的对话框架，还集成了高精度的语音活动检测（VAD）、精准的说话人轮次检测以及多厂商支持的虚拟人唇形同步等关键组件。通过支持 RTC 和 WebSocket 等多种连接方式，并允许灵活扩展记忆模块，ten-framework 让开发者能够专注于业务逻辑创新，而无需重复造轮子，是构建下一代自然流畅人机交互系统的理想选择。","\u003Cdiv align=\"center\" id=\"readme-top\">\n\n![Image][ten-framework-banner]\n\n[![TEN Releases][ten-releases-badge]][ten-releases]\n[![Coverage Status][coverage-badge]][coverage]\n[![Release Date][release-date-badge]][ten-releases]\n[![Commits][commits-badge]][commit-activity]\n[![Issues closed][issues-closed-badge]][issues-closed]\n[![Contributors][contributors-badge]][contributors]\n[![GitHub license][license-badge]][license]\n[![Ask DeepWiki][deepwiki-badge]][deepwiki]\n[![ReadmeX][readmex-badge]][readmex]\n\n[![README in English][lang-en-badge]][lang-en-readme]\n[![简体中文操作指南][lang-zh-badge]][lang-zh-readme]\n[![日本語のREADME][lang-jp-badge]][lang-jp-readme]\n[![README in 한국어][lang-kr-badge]][lang-kr-readme]\n[![README en Español][lang-es-badge]][lang-es-readme]\n[![README en Français][lang-fr-badge]][lang-fr-readme]\n[![README in Italiano][lang-it-badge]][lang-it-readme]\n\n[![TEN-framework%2Ften_framework | Trendshift][trendshift-badge]][trendshift]\n\n[Official Site][official-site] •\n[Documentation][documentation] •\n[Blog][blog]\n\n\u003C\u002Fdiv>\n\n\u003Cbr>\n\n\u003Cdetails open>\n  \u003Csummary>\u003Ckbd>Table of Contents\u003C\u002Fkbd>\u003C\u002Fsummary>\n\n  \u003Cbr>\n\n- [Welcome to TEN][welcome-to-ten]\n- [Agent Examples][agent-examples-section]\n- [Quick Start with Agent Examples][quick-start]\n  - [Localhost][localhost-section]\n  - [Codespaces][codespaces-section]\n- [Agent Examples Self-Hosting][agent-examples-self-hosting]\n  - [Deploying with Docker][deploying-with-docker]\n  - [Deploying with other cloud services][deploying-with-other-cloud-services]\n- [Stay Tuned][stay-tuned]\n- [TEN Ecosystem][ten-ecosystem-anchor]\n- [Questions][questions]\n- [Contributing][contributing]\n  - [Code Contributors][code-contributors]\n  - [Contribution Guidelines][contribution-guidelines]\n  - [License][license-section]\n\n\u003Cbr\u002F>\n\n\u003C\u002Fdetails>\n\n## Welcome to TEN\n\nTEN is an open-source framework for real-time multimodal conversational AI.\n\n[TEN Ecosystem][ten-ecosystem-anchor] includes [TEN Framework][ten-framework], [Agent Examples][agent-examples-repo], [VAD][ten-vad], [Turn Detection][ten-turn-detection] and [Portal][ten-portal].\n\n\u003Cbr>\n\n| Community Channel | Purpose |\n| ---------------- | ------- |\n| [![Follow on X][follow-on-x-badge]][follow-on-x] | Follow TEN Framework on X for updates and announcements |\n| [![Discord TEN Community][discord-badge]][discord-invite] | Join our Discord community to connect with developers |\n| [![Follow on LinkedIn][linkedin-badge]][linkedin] | Follow TEN Framework on LinkedIn for updates and announcements |\n| [![Hugging Face Space][hugging-face-badge]][hugging-face] | Join our Hugging Face community to explore our spaces and models |\n| [![WeChat][wechat-badge]][wechat-discussion] | Join our WeChat group for Chinese community discussions |\n\n\u003Cbr>\n\n## Agent Examples\n\n\u003Cbr>\n\n![Image][voice-assistant-image]\n\n\u003Cstrong>Multi-Purpose Voice Assistant\u003C\u002Fstrong> — This low-latency, high-quality real-time assistant supports both RTC and [WebSocket][websocket-example] connections, and you can extend it with [Memory][memory-example], [VAD][voice-assistant-vad-example], [Turn Detection][voice-assistant-turn-detection-example], and other extensions.\n\nSee the [Example code][voice-assistant-example] for more details.\n\n\u003Cbr>\n\n![divider][divider-light]\n![divider][divider-dark]\n\n\u003Cbr>\n\n\n![Image][doodler-image]\n\n\u003Cstrong>Doodler\u003C\u002Fstrong> — A doodle board that turns spoken or typed prompts into simple hand-drawn sketches, complete with a crayon palette and real-time drawing.\n\n[Example code][doodler-example]\n\n\u003Cbr>\n\n![divider][divider-light]\n![divider][divider-dark]\n\n\u003Cbr>\n\n![Image][speaker-diarization-image]\n\n\u003Cstrong>Speaker Diarization\u003C\u002Fstrong> — Real-time diarization that detects and labels speakers, the Who Likes What game shows an interactive use case.\n\n[Example code][speechmatics-diarization-example]\n\n\u003Cbr>\n\n![divider][divider-light]\n![divider][divider-dark]\n\n\u003Cbr>\n\n![Image][lip-sync-image]\n\n\n\u003Cstrong>Lip Sync Avatars\u003C\u002Fstrong> — Works with multiple avatar vendors, the main character features Kei, an anime character with MotionSync-powered lip sync, and also supports realistic avatars from Trulience, HeyGen, and Tavus.\n\nSee the [Example code][voice-assistant-live2d-example] for different Live2D characters.\n\n\u003Cbr>\n\n![divider][divider-light]\n![divider][divider-dark]\n\n\u003Cbr>\n\n![Image][sip-call-image]\n\n\u003Cstrong>SIP Call\u003C\u002Fstrong> — SIP extension that enables phone calls powered by TEN.\n\n[Example code][voice-assistant-sip-example]\n\n\u003Cbr>\n\n![divider][divider-light]\n![divider][divider-dark]\n\n\u003Cbr>\n\n![Image][transcription-image]\n\n\u003Cstrong>Transcription\u003C\u002Fstrong> — A transcription tool that transcribes audio to text.\n\n[Example code][transcription-example]\n\n\u003Cbr>\n\n![divider][divider-light]\n![divider][divider-dark]\n\n\u003Cbr>\n\n![Image][esp32-image]\n\n\u003Cstrong>ESP32-S3 Korvo V3\u003C\u002Fstrong> — Runs TEN agent example on the Espressif ESP32-S3 Korvo V3 development board to integrate LLM-powered communication with hardware.\n\nSee the [integration guide][esp32-guide] for more details.\n\n\u003Cbr>\n\u003Cdiv align=\"right\">\n\n[![][back-to-top]][readme-top]\n\n\u003C\u002Fdiv>\n\n## Quick Start with Agent Examples\n\n### Localhost\n\n#### Step ⓵ - Prerequisites\n\n| Category | Requirements |\n| --- | --- |\n| **Keys** | • Agora [App ID][agora-app-id] and [App Certificate][agora-app-certificate]\u003Cbr>• [OpenAI][openai-api] API key\u003Cbr>• [Deepgram][deepgram] ASR \u003Cbr>• [ElevenLabs][elevenlabs] TTS  |\n| **Installation** | • [Docker][docker] \u002F [Docker Compose][docker-compose]\u003Cbr>• [Node.js (LTS) v18][nodejs] |\n| **Minimum System Requirements** | • CPU >= 2 cores\u003Cbr>• RAM >= 4 GB |\n\n\u003Cbr>\n\n![divider][divider-light]\n![divider][divider-dark]\n\n\u003C!-- > [!NOTE]\n> **macOS: Docker setting on Apple Silicon**\n>\n> Uncheck \"Use Rosetta for x86\u002Famd64 emulation\" in Docker settings, it may result in slower build times on ARM, but performance will be normal when deployed to x64 servers. -->\n\n#### Step ⓶ - Build agent examples in VM\n\n##### 1. Clone the repo, `cd` into `ai_agents`, and create a `.env` file from `.env.example`\n\n```bash\ncd ai_agents\ncp .\u002F.env.example .\u002F.env\n```\n\n##### 2. Set up the Agora App ID and App Certificate in `.env`\n\n```bash\nAGORA_APP_ID=\nAGORA_APP_CERTIFICATE=\n\n# Deepgram (required for speech-to-text)\nDEEPGRAM_API_KEY=\n\n# OpenAI (required for language model)\nOPENAI_API_KEY=\n\n# ElevenLabs (required for text-to-speech)\nELEVENLABS_TTS_KEY=\n```\n\n##### 3. Start agent development containers\n\n```bash\ndocker compose up -d\n```\n\n##### 4. Enter the container\n\n```bash\ndocker exec -it ten_agent_dev bash\n```\n\n##### 5. Build the agent with the default example (~5-8 min)\n\nCheck the `agents\u002Fexamples` folder for additional samples.\nStart with one of these defaults:\n\n```bash\n# use the chained voice assistant\ncd agents\u002Fexamples\u002Fvoice-assistant\n\n# or use the speech-to-speech voice assistant in real time\ncd agents\u002Fexamples\u002Fvoice-assistant-realtime\n```\n\n##### 6. Start the web server\n\nRun `task build` if you changed any local source code. This step is required for compiled languages (for example, TypeScript or Go) and not needed for Python.\n\n```bash\ntask install\ntask run\n```\n\n##### 7. Access the agent\n\nOnce the agent example is running, you can access the following interfaces:\n\n| **localhost:49483** | **localhost:3000** |\n| :-----------------: | :----------------: |\n| ![Screenshot 1][localhost-49483-image] | ![Screenshot 2][localhost-3000-image] |\n\n- TMAN Designer: [localhost:49483][localhost-49483]\n- Agent Examples UI: [localhost:3000][localhost-3000]\n\n\u003Cbr>\n\n![divider][divider-light]\n![divider][divider-dark]\n\n#### Step ⓷ - Customize your agent example\n\n1. Open [localhost:49483][localhost-49483].\n2. Right-click the STT, LLM, and TTS extensions.\n3. Open their properties and enter the corresponding API keys.\n4. Submit your changes, now you can see the updated Agent Example in [localhost:3000][localhost-3000].\n\n\u003Cbr>\n\n![divider][divider-light]\n![divider][divider-dark]\n\n\u003Cbr>\n\n#### Run a transcriber app from TEN Manager without Docker (Beta)\n\nTEN also provides a transcriber app that you can run from TEN Manager without using Docker.\n\nCheck the [quick start guide][quick-start-guide-ten-manager] for more details.\n\n\u003Cbr>\n\n![divider][divider-light]\n![divider][divider-dark]\n\n\u003Cbr>\n\n### Codespaces\n\nGitHub offers free Codespaces for each repository. You can run Agent Examples in Codespaces without using Docker. Codespaces typically start faster than local Docker environments.\n\n[![][codespaces-shield]][codespaces-new]\n\nCheck out [this guide][codespaces-guide] for more details.\n\n\u003Cdiv align=\"right\">\n\n[![][back-to-top]][readme-top]\n\n\u003C\u002Fdiv>\n\n\u003Cbr>\n\n## Agent Examples Self-Hosting\n\n### Deploying with Docker\n\nOnce you have customized your agent (either by using the TMAN Designer or editing `property.json` directly), you can deploy it by creating a release Docker image for your service.\n\n##### Release as Docker image\n\n**Note**: The following commands need to be executed outside of any Docker container.\n\n###### Build image\n\n```bash\ncd ai_agents\ndocker build -f agents\u002Fexamples\u002F\u003Cexample-name>\u002FDockerfile -t example-app .\n```\n\n###### Run\n\n```bash\ndocker run --rm -it --env-file .env -p 3000:3000 example-app\n```\n\n\u003Cbr>\n\n![divider][divider-light]\n![divider][divider-dark]\n\n### Deploying with other cloud services\n\nYou can split the deployment into two pieces when you want to host TEN on providers such as [Vercel][vercel] or [Netlify][netlify].\n\n1. Run the TEN backend on any container-friendly platform (a VM with Docker, Fly.io, Render, ECS, Cloud Run, or similar). Use the example Docker image without modifying it and expose port `8080` from that service.\n\n2. Deploy only the frontend to Vercel or Netlify. Point the project root to `ai_agents\u002Fagents\u002Fexamples\u002F\u003Cexample>\u002Ffrontend`, run `pnpm install` (or `bun install`) followed by `pnpm build` (or `bun run build`), and keep the default `.next` output directory.\n\n3. Configure environment variables in your hosting dashboard so that `AGENT_SERVER_URL` points to the backend URL, and add any `NEXT_PUBLIC_*` keys the UI needs (for example, Agora credentials you surface to the browser).\n\n4. Ensure your backend accepts requests from the frontend origin — via open CORS or by using the built-in proxy middleware.\n\nWith this setup, the backend handles long-running worker processes, while the hosted frontend simply forwards API traffic to it.\n\n\u003Cdiv align=\"right\">\n\n[![][back-to-top]][readme-top]\n\n\u003C\u002Fdiv>\n\n\u003Cbr>\n\n## Stay Tuned\n\nGet instant notifications for new releases and updates. Your support helps us grow and improve TEN!\n\n\u003Cbr>\n\n![Image][stay-tuned-image]\n\n\u003Cbr>\n\u003Cdiv align=\"right\">\n\n[![][back-to-top]][readme-top]\n\n\u003C\u002Fdiv>\n\n\u003Cbr>\n\n## TEN Ecosystem\n\n\u003Cbr>\n\n| Project | Preview |\n| ------- | ------- |\n| [**️TEN Framework**][ten-framework-link]\u003Cbr>Open-source framework for conversational AI Agents.\u003Cbr>\u003Cbr>![][ten-framework-shield] | ![][ten-framework-banner] |\n| [**TEN VAD**][ten-vad-link]\u003Cbr>Low-latency, lightweight and high-performance streaming voice activity detector (VAD).\u003Cbr>\u003Cbr>![][ten-vad-shield] | ![][ten-vad-banner] |\n| [**️ TEN Turn Detection**][ten-turn-detection-link]\u003Cbr>TEN Turn Detection enables full-duplex dialogue communication.\u003Cbr>\u003Cbr>![][ten-turn-detection-shield] | ![][ten-turn-detection-banner] |\n| [**TEN Agent Examples**][ten-agent-example-link]\u003Cbr>Usecases powered by TEN.\u003Cbr>\u003Cbr> | ![][ten-agent-example-banner] |\n| [**TEN Portal**][ten-portal-link]\u003Cbr>The official site of the TEN Framework with documentation and a blog.\u003Cbr>\u003Cbr>![][ten-portal-shield] | ![][ten-portal-banner] |\n\n\u003Cbr>\n\u003Cdiv align=\"right\">\n\n[![][back-to-top]][readme-top]\n\n\u003C\u002Fdiv>\n\n\u003Cbr>\n\n## Questions\n\nTEN Framework is available on these AI-powered Q&A platforms. They can help you find answers quickly and accurately in multiple languages, covering everything from basic setup to advanced implementation details.\n\n| Service | Link |\n| ------- | ---- |\n| DeepWiki | [![Ask DeepWiki][deepwiki-badge]][deepwiki] |\n| ReadmeX | [![ReadmeX][readmex-badge]][readmex] |\n\n\u003Cbr>\n\u003Cdiv align=\"right\">\n\n[![][back-to-top]][readme-top]\n\n\u003C\u002Fdiv>\n\n## Contributing\n\nWe welcome all forms of open-source collaboration! Whether you're fixing bugs, adding features, improving documentation, or sharing ideas, your contributions help advance personalized AI tools. Check out our GitHub Issues and Projects to find ways to contribute and show your skills. Together, we can build something amazing!\n\n\u003Cbr>\n\n> [!TIP]\n>\n> **Welcome all kinds of contributions** 🙏\n>\n> Join us in building TEN better! Every contribution makes a difference, from code to documentation. Share your TEN Agent projects on social media to inspire others!\n>\n> Connect with one of the TEN maintainers [@elliotchen200][elliotchen200-x] on 𝕏 or [@cyfyifanchen][cyfyifanchen-github] on GitHub for project updates, discussions, and collaboration opportunities.\n\n\u003Cbr>\n\n![divider][divider-light]\n![divider][divider-dark]\n\n### Code Contributors\n\n[![TEN][contributors-image]][contributors]\n\n### Contribution Guidelines\n\nContributions are welcome! Please read the [contribution guidelines][contribution-guidelines-doc] first.\n\n\u003Cbr>\n\n![divider][divider-light]\n![divider][divider-dark]\n\n### License\n\n1. The entire TEN framework (except for the folders explicitly listed below) is released pursuant the Apache License, Version 2.0, with additional restrictions. For details, please refer to the [LICENSE][license-file] file located in the root directory of the TEN framework.\n\n2. The components within the `packages` directory are released under the Apache License, Version 2.0. For details, please refer to the `LICENSE` file located in each package's root directory.\n\n3. The third-party libraries used by the TEN framework are listed and described in detail. For more information, please refer to the [third_party][third-party-folder] folder.\n\n\u003Cdiv align=\"right\">\n\n[![][back-to-top]][readme-top]\n\n\u003C\u002Fdiv>\n\n[back-to-top]: https:\u002F\u002Fimg.shields.io\u002Fbadge\u002F-Back_to_top-gray?style=flat-square\n[readme-top]: #readme-top\n\n\u003C!-- Navigation -->\n[welcome-to-ten]: #welcome-to-ten\n[agent-examples-section]: #agent-examples\n[quick-start]: #quick-start-with-agent-examples\n[localhost-section]: #localhost\n[codespaces-section]: #codespaces\n[agent-examples-self-hosting]: #agent-examples-self-hosting\n[deploying-with-docker]: #deploying-with-docker\n[deploying-with-other-cloud-services]: #deploying-with-other-cloud-services\n[stay-tuned]: #stay-tuned\n[ten-ecosystem-anchor]: #ten-ecosystem\n[questions]: #questions\n[contributing]: #contributing\n[code-contributors]: #code-contributors\n[contribution-guidelines]: #contribution-guidelines\n[license-section]: #license\n\n\u003C!-- Header badges -->\n[ten-releases-badge]: https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fv\u002Frelease\u002Ften-framework\u002Ften-framework?color=369eff&labelColor=gray&logo=github&style=flat-square\n[ten-releases]: https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Freleases\n[coverage-badge]: https:\u002F\u002Fcoveralls.io\u002Frepos\u002Fgithub\u002FTEN-framework\u002Ften-framework\u002Fbadge.svg?branch=main\n[coverage]: https:\u002F\u002Fcoveralls.io\u002Fgithub\u002FTEN-framework\u002Ften-framework?branch=main\n[release-date-badge]: https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Frelease-date\u002Ften-framework\u002Ften-framework?labelColor=gray&style=flat-square\n[commits-badge]: https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fcommit-activity\u002Fm\u002FTEN-framework\u002Ften-framework?labelColor=gray&color=pink\n[commit-activity]: https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fgraphs\u002Fcommit-activity\n[issues-closed-badge]: https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fissues-search?query=repo%3ATEN-framework%2Ften-framework%20is%3Aclosed&label=issues%20closed&labelColor=gray&color=green\n[issues-closed]: https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fissues\n[contributors-badge]: https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fcontributors\u002Ften-framework\u002Ften-framework?color=c4f042&labelColor=gray&style=flat-square\n[contributors]: https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fgraphs\u002Fcontributors\n[license-badge]: https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FLicense-Apache_2.0_with_certain_conditions-blue.svg?labelColor=%20%23155EEF&color=%20%23528bff\n[license]: https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fblob\u002Fmain\u002FLICENSE\n[deepwiki-badge]: https:\u002F\u002Fdeepwiki.com\u002Fbadge.svg\n[deepwiki]: https:\u002F\u002Fdeepwiki.com\u002FTEN-framework\u002FTEN-framework\n[readmex-badge]: https:\u002F\u002Fraw.githubusercontent.com\u002FCodePhiliaX\u002Fresource-trusteeship\u002Fmain\u002Freadmex.svg\n[readmex]: https:\u002F\u002Freadmex.com\u002FTEN-framework\u002Ften-framework\n[trendshift-badge]: https:\u002F\u002Ftrendshift.io\u002Fapi\u002Fbadge\u002Frepositories\u002F11978\n[trendshift]: https:\u002F\u002Ftrendshift.io\u002Frepositories\u002F11978\n\n\u003C!-- Localized READMEs -->\n[lang-en-badge]: https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FEnglish-lightgrey\n[lang-en-readme]: https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fblob\u002Fmain\u002FREADME.md\n[lang-zh-badge]: https:\u002F\u002Fimg.shields.io\u002Fbadge\u002F简体中文-lightgrey\n[lang-zh-readme]: https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fblob\u002Fmain\u002Fdocs\u002FREADME-CN.md\n[lang-jp-badge]: https:\u002F\u002Fimg.shields.io\u002Fbadge\u002F日本語-lightgrey\n[lang-jp-readme]: https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fblob\u002Fmain\u002Fdocs\u002FREADME-JP.md\n[lang-kr-badge]: https:\u002F\u002Fimg.shields.io\u002Fbadge\u002F한국어-lightgrey\n[lang-kr-readme]: https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fblob\u002Fmain\u002Fdocs\u002FREADME-KR.md\n[lang-es-badge]: https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FEspañol-lightgrey\n[lang-es-readme]: https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fblob\u002Fmain\u002Fdocs\u002FREADME-ES.md\n[lang-fr-badge]: https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FFrançais-lightgrey\n[lang-fr-readme]: https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fblob\u002Fmain\u002Fdocs\u002FREADME-FR.md\n[lang-it-badge]: https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FItaliano-lightgrey\n[lang-it-readme]: https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fblob\u002Fmain\u002Fdocs\u002FREADME-IT.md\n\n\u003C!-- Primary sites -->\n[official-site]: https:\u002F\u002Ftheten.ai\n[documentation]: https:\u002F\u002Ftheten.ai\u002Fdocs\n[blog]: https:\u002F\u002Ftheten.ai\u002Fblog\n\n\u003C!-- Welcome -->\n[ten-framework]: https:\u002F\u002Fgithub.com\u002Ften-framework\u002Ften-framework\n[agent-examples-repo]: https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Ftree\u002Fmain\u002Fai_agents\u002Fagents\u002Fexamples\n[ten-vad]: https:\u002F\u002Fgithub.com\u002Ften-framework\u002Ften-vad\n[ten-turn-detection]: https:\u002F\u002Fgithub.com\u002Ften-framework\u002Ften-turn-detection\n[ten-portal]: https:\u002F\u002Fgithub.com\u002Ften-framework\u002Fportal\n\n\u003C!-- Community -->\n[follow-on-x-badge]: https:\u002F\u002Fimg.shields.io\u002Ftwitter\u002Ffollow\u002FTenFramework?logo=X&color=%20%23f5f5f5\n[follow-on-x]: https:\u002F\u002Ftwitter.com\u002Fintent\u002Ffollow?screen_name=TenFramework\n[discord-badge]: https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FDiscord-Join%20TEN%20Community-5865F2?style=flat&logo=discord&logoColor=white\n[discord-invite]: https:\u002F\u002Fdiscord.gg\u002FVnPftUzAMJ\n[linkedin-badge]: https:\u002F\u002Fcustom-icon-badges.demolab.com\u002Fbadge\u002FLinkedIn-TEN_Framework-0A66C2?logo=linkedin-white&logoColor=fff\n[linkedin]: https:\u002F\u002Fwww.linkedin.com\u002Fcompany\u002Ften-framework\n[hugging-face-badge]: https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FHugging%20Face-TEN%20Framework-yellow?style=flat&logo=huggingface\n[hugging-face]: https:\u002F\u002Fhuggingface.co\u002FTEN-framework\n[wechat-badge]: https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FTEN_Framework-WeChat_Group-%2307C160?logo=wechat&labelColor=darkgreen&color=gray\n[wechat-discussion]: https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-agent\u002Fdiscussions\u002F170\n\n\u003C!-- Agent examples -->\n[voice-assistant-image]: https:\u002F\u002Fgithub.com\u002Fuser-attachments\u002Fassets\u002Fdce3db80-fb48-4e2a-8ac7-33f50bcffa32\n[websocket-example]: ai_agents\u002Fagents\u002Fexamples\u002Fwebsocket-example\n[memory-example]: ai_agents\u002Fagents\u002Fexamples\u002Fvoice-assistant-with-memU\n[voice-assistant-vad-example]: ai_agents\u002Fagents\u002Fexamples\u002Fvoice-assistant-with-ten-vad\n[voice-assistant-turn-detection-example]: ai_agents\u002Fagents\u002Fexamples\u002Fvoice-assistant-with-turn-detection\n[voice-assistant-example]: ai_agents\u002Fagents\u002Fexamples\u002Fvoice-assistant\n[divider-light]: https:\u002F\u002Fgithub.com\u002Fuser-attachments\u002Fassets\u002Faec54c94-ced9-4683-ae58-0a5a7ed803bd#gh-light-mode-only\n[divider-dark]: https:\u002F\u002Fgithub.com\u002Fuser-attachments\u002Fassets\u002Fd57fad08-4f49-4a1c-bdfc-f659a5d86150#gh-dark-mode-only\n[lip-sync-image]: https:\u002F\u002Fgithub.com\u002Fuser-attachments\u002Fassets\u002F51ab1504-b67c-49d4-8a7a-5582d9b254da\n[voice-assistant-live2d-example]: ai_agents\u002Fagents\u002Fexamples\u002Fvoice-assistant-live2d\n[speaker-diarization-image]: https:\u002F\u002Fgithub.com\u002Fuser-attachments\u002Fassets\u002Ff94b21b8-9dda-4efc-9274-b028cc01296a\n[speechmatics-diarization-example]: ai_agents\u002Fagents\u002Fexamples\u002Fspeaker-diarization\n[sip-call-image]: https:\u002F\u002Fgithub.com\u002Fuser-attachments\u002Fassets\u002F6ed5b04d-945a-4a30-a1cc-f8014b602b38\n[voice-assistant-sip-example]: ai_agents\u002Fagents\u002Fexamples\u002Fvoice-assistant-sip-twilio\n[transcription-image]: https:\u002F\u002Fgithub.com\u002Fuser-attachments\u002Fassets\u002Fd793bc6c-c8de-4996-bd85-9ce88c69dd8d\n[transcription-example]: ai_agents\u002Fagents\u002Fexamples\u002Ftranscription\n[doodler-image]: https:\u002F\u002Fgithub.com\u002Fuser-attachments\u002Fassets\u002F80c4eabd-de96-4971-8956-6b365d4fbd64\n[doodler-example]: ai_agents\u002Fagents\u002Fexamples\u002Fdoodler\n[esp32-image]: https:\u002F\u002Fgithub.com\u002Fuser-attachments\u002Fassets\u002F3d60f1ff-0f82-4fe7-b5c2-ac03d284f60c\n[esp32-guide]: ai_agents\u002Fesp32-client\n\n\u003C!-- Quick start -->\n[agora-app-id]: https:\u002F\u002Fdocs.agora.io\u002Fen\u002Fvideo-calling\u002Fget-started\u002Fmanage-agora-account?platform=web#create-an-agora-project\n[agora-app-certificate]: https:\u002F\u002Fdocs.agora.io\u002Fen\u002Fvideo-calling\u002Fget-started\u002Fmanage-agora-account?platform=web#create-an-agora-project\n[openai-api]: https:\u002F\u002Fopenai.com\u002Findex\u002Fopenai-api\u002F\n[deepgram]: https:\u002F\u002Fdeepgram.com\u002F\n[elevenlabs]: https:\u002F\u002Felevenlabs.io\u002F\n[docker]: https:\u002F\u002Fwww.docker.com\u002F\n[docker-compose]: https:\u002F\u002Fdocs.docker.com\u002Fcompose\u002F\n[nodejs]: https:\u002F\u002Fnodejs.org\u002Fen\n[quick-start-guide-ten-manager]: https:\u002F\u002Ftheten.ai\u002Fdocs\u002Ften_framework\u002Fgetting-started\u002Fquick-start\n[localhost-49483-image]: https:\u002F\u002Fgithub.com\u002Fuser-attachments\u002Fassets\u002F191a7c0a-d8e6-48f9-866f-6a70c58f0118\n[localhost-3000-image]: https:\u002F\u002Fgithub.com\u002Fuser-attachments\u002Fassets\u002F13e482b6-d907-4449-a779-9454bb24c0b1\n[localhost-49483]: http:\u002F\u002Flocalhost:49483\n[localhost-3000]: http:\u002F\u002Flocalhost:3000\n\n\u003C!-- Codespaces -->\n[codespaces-shield]: https:\u002F\u002Fgithub.com\u002Fcodespaces\u002Fbadge.svg\n[codespaces-new]: https:\u002F\u002Fcodespaces.new\u002Ften-framework\u002Ften-agent\n[codespaces-guide]: https:\u002F\u002Ftheten.ai\u002Fdocs\u002Ften_agent_examples\u002Fsetup_development_env\u002Fsetting_up_development_inside_codespace\n\n\u003C!-- Deployment -->\n[vercel]: https:\u002F\u002Fvercel.com\n[netlify]: https:\u002F\u002Fwww.netlify.com\n\n\u003C!-- Stay tuned -->\n[stay-tuned-image]: https:\u002F\u002Fgithub.com\u002Fuser-attachments\u002Fassets\u002F72c6cc46-a2a2-484d-82a9-f3079269c815\n\n\u003C!-- TEN ecosystem -->\n[ten-framework-shield]: https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fstars\u002Ften-framework\u002Ften-framework?color=ffcb47&labelColor=gray&style=flat-square&logo=github\n[ten-framework-banner]: https:\u002F\u002Fgithub.com\u002Fuser-attachments\u002Fassets\u002F799584b2-61ff-4255-bdd1-2548d0fdba52\n[ten-framework-link]: https:\u002F\u002Fgithub.com\u002Ften-framework\u002Ften-framework\n\n[ten-vad-link]: https:\u002F\u002Fgithub.com\u002Ften-framework\u002Ften-vad\n[ten-vad-shield]: https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fstars\u002Ften-framework\u002Ften-vad?color=ffcb47&labelColor=gray&style=flat-square&logo=github\n[ten-vad-banner]: https:\u002F\u002Fgithub.com\u002Fuser-attachments\u002Fassets\u002Fe504135e-67fd-4fa1-b0e4-d495358d8aa5\n\n[ten-turn-detection-link]: https:\u002F\u002Fgithub.com\u002Ften-framework\u002Ften-turn-detection\n[ten-turn-detection-shield]: https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fstars\u002Ften-framework\u002Ften-turn-detection?color=ffcb47&labelColor=gray&style=flat-square&logo=github\n[ten-turn-detection-banner]: https:\u002F\u002Fgithub.com\u002Fuser-attachments\u002Fassets\u002Fc72d82cc-3667-496c-8bd6-3d194a91c452\n\n[ten-agent-example-link]: https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Ftree\u002Fmain\u002Fai_agents\u002Fagents\u002Fexamples\n[ten-agent-example-banner]: https:\u002F\u002Fgithub.com\u002Fuser-attachments\u002Fassets\u002F7f735633-c7f6-4432-b6b4-d2a2977ca588\n\n[ten-portal-link]: https:\u002F\u002Fgithub.com\u002Ften-framework\u002Fportal\n[ten-portal-shield]: https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fstars\u002Ften-framework\u002Fportal?color=ffcb47&labelColor=gray&style=flat-square&logo=github\n[ten-portal-banner]: https:\u002F\u002Fgithub.com\u002Fuser-attachments\u002Fassets\u002Ff56c75b9-722c-4156-902d-ae98ce2b3b5e\n\n\u003C!-- Contributing -->\n[elliotchen200-x]: https:\u002F\u002Fx.com\u002Felliotchen200\n[cyfyifanchen-github]: https:\u002F\u002Fgithub.com\u002Fcyfyifanchen\n[contributors-image]: https:\u002F\u002Fcontrib.rocks\u002Fimage?repo=TEN-framework\u002Ften-framework\n[contribution-guidelines-doc]: .\u002Fdocs\u002Fcode-of-conduct\u002Fcontributing.md\n[license-file]: .\u002FLICENSE\n[third-party-folder]: .\u002Fthird_party\u002F\n","\u003Cdiv align=\"center\" id=\"readme-top\">\n\n![图片][ten-framework-banner]\n\n[![TEN 发布版本][ten-releases-badge]][ten-releases]\n[![覆盖率][coverage-badge]][coverage]\n[![发布日期][release-date-badge]][ten-releases]\n[![提交次数][commits-badge]][commit-activity]\n[![已关闭的问题][issues-closed-badge]][issues-closed]\n[![贡献者][contributors-badge]][contributors]\n[![GitHub 许可证][license-badge]][license]\n[![Ask DeepWiki][deepwiki-badge]][deepwiki]\n[![ReadmeX][readmex-badge]][readmex]\n\n[![英文 README][lang-en-badge]][lang-en-readme]\n[![简体中文操作指南][lang-zh-badge]][lang-zh-readme]\n[![日本語のREADME][lang-jp-badge]][lang-jp-readme]\n[![README 在韩语中][lang-kr-badge]][lang-kr-readme]\n[![西班牙语的 README][lang-es-badge]][lang-es-readme]\n[![法语的 README][lang-fr-badge]][lang-fr-readme]\n[![意大利语的 README][lang-it-badge]][lang-it-readme]\n\n[![TEN-framework%2Ften_framework | Trendshift][trendshift-badge]][trendshift]\n\n[官方网站][official-site] •\n[文档][documentation] •\n[博客][blog]\n\n\u003C\u002Fdiv>\n\n\u003Cbr>\n\n\u003Cdetails open>\n  \u003Csummary>\u003Ckbd>目录\u003C\u002Fkbd>\u003C\u002Fsummary>\n\n  \u003Cbr>\n\n- [欢迎来到 TEN][welcome-to-ten]\n- [代理示例][agent-examples-section]\n- [通过代理示例快速入门][quick-start]\n  - [本地主机][localhost-section]\n  - [Codespaces][codespaces-section]\n- [代理示例自托管][agent-examples-self-hosting]\n  - [使用 Docker 部署][deploying-with-docker]\n  - [使用其他云服务部署][deploying-with-other-cloud-services]\n- [敬请期待][stay-tuned]\n- [TEN 生态系统][ten-ecosystem-anchor]\n- [问题][questions]\n- [贡献][contributing]\n  - [代码贡献者][code-contributors]\n  - [贡献指南][contribution-guidelines]\n  - [许可证][license-section]\n\n\u003Cbr\u002F>\n\n\u003C\u002Fdetails>\n\n## 欢迎来到 TEN\n\nTEN 是一个用于实时多模态对话式 AI 的开源框架。\n\n[TEN 生态系统][ten-ecosystem-anchor] 包括 [TEN 框架][ten-framework], [代理示例][agent-examples-repo], [VAD][ten-vad], [轮次检测][ten-turn-detection] 和 [Portal][ten-portal]。\n\n\u003Cbr>\n\n| 社区频道 | 目的 |\n| ---------------- | ------- |\n| [![在 X 上关注][follow-on-x-badge]][follow-on-x] | 在 X 上关注 TEN 框架，获取最新动态和公告 |\n| [![Discord TEN 社区][discord-badge]][discord-invite] | 加入我们的 Discord 社区，与开发者交流 |\n| [![在 LinkedIn 上关注][linkedin-badge]][linkedin] | 在 LinkedIn 上关注 TEN 框架，获取最新动态和公告 |\n| [![Hugging Face Space][hugging-face-badge]][hugging-face] | 加入我们的 Hugging Face 社区，探索我们的空间和模型 |\n| [![微信][wechat-badge]][wechat-discussion] | 加入我们的微信群，参与中文社区讨论 |\n\n\u003Cbr>\n\n## 代理示例\n\n\u003Cbr>\n\n![图片][voice-assistant-image]\n\n\u003Cstrong>多功能语音助手\u003C\u002Fstrong> — 这款低延迟、高质量的实时助手支持 RTC 和 [WebSocket][websocket-example] 连接，您还可以通过 [Memory][memory-example], [VAD][voice-assistant-vad-example], [Turn Detection][voice-assistant-turn-detection-example] 等扩展功能对其进行扩展。\n\n更多详情请参阅 [示例代码][voice-assistant-example]。\n\n\u003Cbr>\n\n![分隔线][divider-light]\n![分隔线][divider-dark]\n\n\u003Cbr>\n\n\n![图片][doodler-image]\n\n\u003Cstrong>涂鸦板\u003C\u002Fstrong> — 一款能够将口头或键入的提示转化为简单手绘草图的涂鸦板，配有蜡笔调色板和实时绘图功能。\n\n[示例代码][doodler-example]\n\n\u003Cbr>\n\n![分隔线][divider-light]\n![分隔线][divider-dark]\n\n\u003Cbr>\n\n![图片][speaker-diarization-image]\n\n\u003Cstrong>说话人辨识\u003C\u002Fstrong> — 实时说话人辨识功能可以检测并标记不同的说话人；“谁喜欢什么”游戏展示了其交互式应用场景。\n\n[示例代码][speechmatics-diarization-example]\n\n\u003Cbr>\n\n![分隔线][divider-light]\n![分隔线][divider-dark]\n\n\u003Cbr>\n\n![图片][lip-sync-image]\n\n\n\u003Cstrong>唇同步虚拟形象\u003C\u002Fstrong> — 支持多家虚拟形象供应商，主角是 Kei，一个由 MotionSync 提供唇同步技术的动漫角色；同时也支持来自 Trulience、HeyGen 和 Tavus 的逼真虚拟形象。\n\n有关不同 Live2D 角色的 [示例代码][voice-assistant-live2d-example] 请参阅。\n\n\u003Cbr>\n\n![分隔线][divider-light]\n![分隔线][divider-dark]\n\n\u003Cbr>\n\n![图片][sip-call-image]\n\n\u003Cstrong>SIP 通话\u003C\u002Fstrong> — 一个基于 TEN 的 SIP 扩展模块，可用于实现电话通话功能。\n\n[示例代码][voice-assistant-sip-example]\n\n\u003Cbr>\n\n![分隔线][divider-light]\n![分隔线][divider-dark]\n\n\u003Cbr>\n\n![图片][transcription-image]\n\n\u003Cstrong>转录\u003C\u002Fstrong> — 一款将音频转录为文本的工具。\n\n[示例代码][transcription-example]\n\n\u003Cbr>\n\n![分隔线][divider-light]\n![分隔线][divider-dark]\n\n\u003Cbr>\n\n![图片][esp32-image]\n\n\u003Cstrong>ESP32-S3 Korvo V3\u003C\u002Fstrong> — 在 Espressif ESP32-S3 Korvo V3 开发板上运行 TEN 代理示例，以实现 LLM 驱动的通信与硬件的集成。\n\n更多详情请参阅 [集成指南][esp32-guide]。\n\n\u003Cbr>\n\u003Cdiv align=\"right\">\n\n[![][back-to-top]][readme-top]\n\n\u003C\u002Fdiv>\n\n## 通过代理示例快速入门\n\n### 本地主机\n\n#### 步骤 ⓵ - 先决条件\n\n| 类别 | 要求 |\n| --- | --- |\n| **密钥** | • Agora [App ID][agora-app-id] 和 [App Certificate][agora-app-certificate]\u003Cbr>• [OpenAI][openai-api] API 密钥\u003Cbr>• [Deepgram][deepgram] ASR\u003Cbr>• [ElevenLabs][elevenlabs] TTS |\n| **安装** | • [Docker][docker] \u002F [Docker Compose][docker-compose]\u003Cbr>• [Node.js (LTS) v18][nodejs] |\n| **最低系统要求** | • CPU >= 2 核\u003Cbr>• 内存 >= 4 GB |\n\n\u003Cbr>\n\n![分隔线][divider-light]\n![分隔线][divider-dark]\n\n\u003C!-- > [!NOTE]\n> **macOS: Docker 设置在 Apple Silicon 上**\n>\n> 在 Docker 设置中取消勾选“使用 Rosetta 进行 x86\u002Famd64 模拟”，这可能会导致在 ARM 架构上的构建时间变长，但在部署到 x64 服务器时性能会恢复正常。 -->\n\n#### 步骤 ⓶ - 在虚拟机中构建代理示例\n\n##### 1. 克隆仓库，进入 `ai_agents` 目录，并从 `.env.example` 文件创建 `.env` 文件\n\n```bash\ncd ai_agents\ncp .\u002F.env.example .\u002F.env\n```\n\n##### 2. 在 `.env` 文件中设置 Agora App ID 和 App Certificate\n\n```bash\nAGORA_APP_ID=\nAGORA_APP_CERTIFICATE=\n\n# Deepgram（用于语音转文字）\nDEEPGRAM_API_KEY=\n\n# OpenAI（用于语言模型）\nOPENAI_API_KEY=\n\n# ElevenLabs（用于文本到语音）\nELEVENLABS_TTS_KEY=\n```\n\n##### 3. 启动代理开发容器\n\n```bash\ndocker compose up -d\n```\n\n##### 4. 进入容器\n\n```bash\ndocker exec -it ten_agent_dev bash\n```\n\n##### 5. 使用默认示例构建代理（约 5–8 分钟）\n\n请查看 `agents\u002Fexamples` 文件夹以获取更多示例。可以从以下默认示例开始：\n\n```bash\n# 使用串联的语音助手\ncd agents\u002Fexamples\u002Fvoice-assistant\n\n# 或者使用实时语音到语音的语音助手\ncd agents\u002Fexamples\u002Fvoice-assistant-realtime\n```\n\n##### 6. 启动 Web 服务器\n\n如果你修改了任何本地源代码，请运行 `task build`。这一步对于编译型语言（例如 TypeScript 或 Go）是必需的，而对于 Python 则不需要。\n\n```bash\ntask install\ntask run\n```\n\n##### 7. 访问代理\n\n一旦代理示例运行起来，你就可以访问以下界面：\n\n| **localhost:49483** | **localhost:3000** |\n| :-----------------: | :----------------: |\n| ![截图 1][localhost-49483-image] | ![截图 2][localhost-3000-image] |\n\n- TMAN 设计器：[localhost:49483][localhost-49483]\n- 代理示例 UI：[localhost:3000][localhost-3000]\n\n\u003Cbr>\n\n![分隔线][divider-light]\n![分隔线][divider-dark]\n\n#### 步骤 ③ - 自定义你的代理示例\n\n1. 打开 [localhost:49483][localhost-49483]。\n2. 右键点击 STT、LLM 和 TTS 扩展。\n3. 打开它们的属性并输入相应的 API 密钥。\n4. 提交更改后，你现在可以在 [localhost:3000][localhost-3000] 看到更新后的代理示例。\n\n\u003Cbr>\n\n![分隔线][divider-light]\n![分隔线][divider-dark]\n\n\u003Cbr>\n\n#### 在不使用 Docker 的情况下从 TEN 管理器运行转录应用（测试版）\n\nTEN 还提供了一个转录应用，你可以直接从 TEN 管理器运行，无需使用 Docker。\n\n更多详情请参阅 [快速入门指南][quick-start-guide-ten-manager]。\n\n\u003Cbr>\n\n![分隔线][divider-light]\n![分隔线][divider-dark]\n\n\u003Cbr>\n\n### Codespaces\n\nGitHub 为每个仓库提供免费的 Codespaces。你可以在 Codespaces 中运行代理示例，而无需使用 Docker。Codespaces 的启动速度通常比本地 Docker 环境更快。\n\n[![][codespaces-shield]][codespaces-new]\n\n更多详情请参阅 [此指南][codespaces-guide]。\n\n\u003Cdiv align=\"right\">\n\n[![][back-to-top]][readme-top]\n\n\u003C\u002Fdiv>\n\n\u003Cbr>\n\n## 代理示例的自托管\n\n### 使用 Docker 部署\n\n一旦你自定义好你的代理（无论是通过 TMAN 设计器还是直接编辑 `property.json`），你就可以为你的服务创建一个发布版的 Docker 镜像来部署它。\n\n##### 以 Docker 镜像形式发布\n\n**注意**：以下命令需要在任何 Docker 容器之外执行。\n\n###### 构建镜像\n\n```bash\ncd ai_agents\ndocker build -f agents\u002Fexamples\u002F\u003Cexample-name>\u002FDockerfile -t example-app .\n```\n\n###### 运行\n\n```bash\ndocker run --rm -it --env-file .env -p 3000:3000 example-app\n```\n\n\u003Cbr>\n\n![分隔线][divider-light]\n![分隔线][divider-dark]\n\n### 使用其他云服务部署\n\n如果你想将 TEN 托管在诸如 [Vercel][vercel] 或 [Netlify][netlify] 等平台上，可以将部署分为两部分。\n\n1. 将 TEN 后端运行在任何支持容器的平台上（如带有 Docker 的虚拟机、Fly.io、Render、ECS、Cloud Run 等）。使用示例 Docker 镜像而不做任何修改，并暴露该服务的 `8080` 端口。\n\n2. 只将前端部署到 Vercel 或 Netlify。将项目根目录指向 `ai_agents\u002Fagents\u002Fexamples\u002F\u003Cexample>\u002Ffrontend`，运行 `pnpm install`（或 `bun install`），然后运行 `pnpm build`（或 `bun run build`），并保持默认的 `.next` 输出目录。\n\n3. 在你的托管仪表板中配置环境变量，使 `AGENT_SERVER_URL` 指向后端 URL，并添加 UI 所需的任何 `NEXT_PUBLIC_*` 键（例如，你需要暴露给浏览器的 Agora 凭证）。\n\n4. 确保你的后端能够接受来自前端来源的请求——可以通过开放 CORS 或使用内置的代理中间件来实现。\n\n通过这种设置，后端负责处理长时间运行的工作进程，而托管的前端则简单地将 API 流量转发到后端。\n\n\u003Cdiv align=\"right\">\n\n[![][back-to-top]][readme-top]\n\n\u003C\u002Fdiv>\n\n\u003Cbr>\n\n## 敬请关注\n\n获取新版本和更新的即时通知。你的支持将帮助我们不断成长并改进 TEN！\n\n\u003Cbr>\n\n![图片][stay-tuned-image]\n\n\u003Cbr>\n\u003Cdiv align=\"right\">\n\n[![][back-to-top]][readme-top]\n\n\u003C\u002Fdiv>\n\n\u003Cbr>\n\n## TEN 生态系统\n\n\u003Cbr>\n\n| 项目 | 预览 |\n| ------- | ------- |\n| [**️TEN 框架**][ten-framework-link]\u003Cbr>用于对话式 AI 代理的开源框架。\u003Cbr>\u003Cbr>![][ten-framework-shield] | ![][ten-framework-banner] |\n| [**TEN VAD**][ten-vad-link]\u003Cbr>低延迟、轻量级且高性能的流式语音活动检测器 (VAD)。\u003Cbr>\u003Cbr>![][ten-vad-shield] | ![][ten-vad-banner] |\n| [**️ TEN 轮次检测**][ten-turn-detection-link]\u003Cbr>TEN 轮次检测实现了全双工对话通信。\u003Cbr>\u003Cbr>![][ten-turn-detection-shield] | ![][ten-turn-detection-banner] |\n| [**TEN 代理示例**][ten-agent-example-link]\u003Cbr>TEN 驱动的应用场景。\u003Cbr>\u003Cbr> | ![][ten-agent-example-banner] |\n| [**TEN 门户**][ten-portal-link]\u003Cbr>TEN 框架的官方网站，包含文档和博客。\u003Cbr>\u003Cbr>![][ten-portal-shield] | ![][ten-portal-banner] |\n\n\u003Cbr>\n\u003Cdiv align=\"right\">\n\n[![][back-to-top]][readme-top]\n\n\u003C\u002Fdiv>\n\n\u003Cbr>\n\n## 问答\n\nTEN 框架可在这些由 AI 驱动的问答平台上使用。它们可以帮助你快速准确地找到答案，支持多种语言，涵盖从基础设置到高级实现细节的各个方面。\n\n| 服务 | 链接 |\n| ------- | ---- |\n| DeepWiki | [![Ask DeepWiki][deepwiki-badge]][deepwiki] |\n| ReadmeX | [![ReadmeX][readmex-badge]][readmex] |\n\n\u003Cbr>\n\u003Cdiv align=\"right\">\n\n[![][back-to-top]][readme-top]\n\n\u003C\u002Fdiv>\n\n## 贡献\n\n我们欢迎任何形式的开源协作！无论你是修复 bug、添加功能、改进文档，还是分享想法，你的贡献都有助于推动个性化 AI 工具的发展。请查看我们的 GitHub Issues 和 Projects，寻找参与贡献的方式，展示你的技能。让我们一起打造令人惊叹的成果！\n\n\u003Cbr>\n\n> [!提示]\n>\n> **欢迎各种形式的贡献** 🙏\n>\n> 加入我们，共同让 TEN 更加完善！每一次贡献都至关重要，无论是代码还是文档。请在社交媒体上分享你的 TEN 代理项目，激励他人！\n>\n> 与 TEN 的维护者之一 [@elliotchen200][elliotchen200-x] 在 𝕏 上，或 [@cyfyifanchen][cyfyifanchen-github] 在 GitHub 上联系，以获取项目更新、讨论及合作机会。\n\n\u003Cbr>\n\n![分隔线][divider-light]\n![分隔线][divider-dark]\n\n### 代码贡献者\n\n[![TEN][contributors-image]][contributors]\n\n### 贡献指南\n\n欢迎贡献！请先阅读 [贡献指南][contribution-guidelines-doc]。\n\n\u003Cbr>\n\n![分隔线][divider-light]\n![分隔线][divider-dark]\n\n### 许可证\n\n1. 整个 TEN 框架（除下面明确列出的文件夹外）根据 Apache 许可证 2.0 版本发布，并附加了一些限制。详细信息请参阅位于 TEN 框架根目录下的 [LICENSE][license-file] 文件。\n\n2. `packages` 目录中的组件根据 Apache 许可证 2.0 版本发布。详细信息请参阅每个包根目录下的 `LICENSE` 文件。\n\n3. TEN 框架所使用的第三方库已在列表中详细列出并说明。更多信息请参阅 [third_party][third-party-folder] 文件夹。\n\n\u003Cdiv align=\"right\">\n\n[![][返回顶部]][readme-top]\n\n\u003C\u002Fdiv>\n\n[返回顶部]: https:\u002F\u002Fimg.shields.io\u002Fbadge\u002F-Back_to_top-gray?style=flat-square\n[readme-top]: #readme-top\n\n\u003C!-- 导航 -->\n[欢迎来到Ten]: #welcome-to-ten\n[代理示例部分]: #agent-examples\n[快速入门]: #quick-start-with-agent-examples\n[本地主机部分]: #localhost\n[Codespaces部分]: #codespaces\n[代理示例自托管]: #agent-examples-self-hosting\n[使用 Docker 部署]: #deploying-with-docker\n[使用其他云服务部署]: #deploying-with-other-cloud-services\n[敬请期待]: #stay-tuned\n[Ten 生态系统锚点]: #ten-ecosystem\n[问题]: #questions\n[贡献]: #contributing\n[代码贡献者]: #code-contributors\n[贡献指南]: #contribution-guidelines\n[许可证部分]: #license\n\n\u003C!-- 页眉徽章 -->\n[Ten 发布版本徽章]: https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fv\u002Frelease\u002Ften-framework\u002Ften-framework?color=369eff&labelColor=gray&logo=github&style=flat-square\n[Ten 发布版本]: https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Freleases\n[覆盖率徽章]: https:\u002F\u002Fcoveralls.io\u002Frepos\u002Fgithub\u002FTEN-framework\u002Ften-framework\u002Fbadge.svg?branch=main\n[覆盖率]: https:\u002F\u002Fcoveralls.io\u002Fgithub\u002FTEN-framework\u002Ften-framework?branch=main\n[发布日期徽章]: https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Frelease-date\u002Ften-framework\u002Ften-framework?labelColor=gray&style=flat-square\n[提交次数徽章]: https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fcommit-activity\u002Fm\u002FTEN-framework\u002Ften-framework?labelColor=gray&color=pink\n[提交活动]: https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fgraphs\u002Fcommit-activity\n[已关闭问题徽章]: https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fissues-search?query=repo%3ATEN-framework%2Ften-framework%20is%3Aclosed&label=issues%20closed&labelColor=gray&color=green\n[已关闭的问题]: https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fissues\n[贡献者徽章]: https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fcontributors\u002Ften-framework\u002Ften-framework?color=c4f042&labelColor=gray&style=flat-square\n[贡献者]: https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fgraphs\u002Fcontributors\n[许可证徽章]: https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FLicense-Apache_2.0_with_certain_conditions-blue.svg?labelColor=%20%23155EEF&color=%20%23528bff\n[许可证]: https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fblob\u002Fmain\u002FLICENSE\n[DeepWiki 徽章]: https:\u002F\u002Fdeepwiki.com\u002Fbadge.svg\n[DeepWiki]: https:\u002F\u002Fdeepwiki.com\u002FTEN-framework\u002FTEN-framework\n[Readmex 徽章]: https:\u002F\u002Fraw.githubusercontent.com\u002FCodePhiliaX\u002Fresource-trusteeship\u002Fmain\u002Freadmex.svg\n[Readmex]: https:\u002F\u002Freadmex.com\u002FTEN-framework\u002Ften-framework\n[Trendshift 徽章]: https:\u002F\u002Ftrendshift.io\u002Fapi\u002Fbadge\u002Frepositories\u002F11978\n[Trendshift]: https:\u002F\u002Ftrendshift.io\u002Frepositories\u002F11978\n\n\u003C!-- 多语言 README -->\n[英语语言徽章]: https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FEnglish-lightgrey\n[英语版 README]: https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fblob\u002Fmain\u002FREADME.md\n[简体中文语言徽章]: https:\u002F\u002Fimg.shields.io\u002Fbadge\u002F简体中文-lightgrey\n[简体中文版 README]: https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fblob\u002Fmain\u002Fdocs\u002FREADME-CN.md\n[日语语言徽章]: https:\u002F\u002Fimg.shields.io\u002Fbadge\u002F日本語-lightgrey\n[日语版 README]: https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fblob\u002Fmain\u002Fdocs\u002FREADME-JP.md\n[韩语语言徽章]: https:\u002F\u002Fimg.shields.io\u002Fbadge\u002F한국어-lightgrey\n[韩语版 README]: https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fblob\u002Fmain\u002Fdocs\u002FREADME-KR.md\n[西班牙语语言徽章]: https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FEspañol-lightgrey\n[西班牙语版 README]: https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fblob\u002Fmain\u002Fdocs\u002FREADME-ES.md\n[法语语言徽章]: https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FFrançais-lightgrey\n[法语版 README]: https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fblob\u002Fmain\u002Fdocs\u002FREADME-FR.md\n[意大利语语言徽章]: https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FItaliano-lightgrey\n[意大利语版 README]: https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fblob\u002Fmain\u002Fdocs\u002FREADME-IT.md\n\n\u003C!-- 主要站点 -->\n[官方网站]: https:\u002F\u002Ftheten.ai\n[文档]: https:\u002F\u002Ftheten.ai\u002Fdocs\n[博客]: https:\u002F\u002Ftheten.ai\u002Fblog\n\n\u003C!-- 欢迎 -->\n[Ten 框架]: https:\u002F\u002Fgithub.com\u002Ften-framework\u002Ften-framework\n[代理示例仓库]: https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Ftree\u002Fmain\u002Fai_agents\u002Fagents\u002Fexamples\n[Ten VAD]: https:\u002F\u002Fgithub.com\u002Ften-framework\u002Ften-vad\n[Ten 轮次检测]: https:\u002F\u002Fgithub.com\u002Ften-framework\u002Ften-turn-detection\n[Ten 门户]: https:\u002F\u002Fgithub.com\u002Ften-framework\u002Fportal\n\n\u003C!-- 社区 -->\n[在 X 上关注徽章]: https:\u002F\u002Fimg.shields.io\u002Ftwitter\u002Ffollow\u002FTenFramework?logo=X&color=%20%23f5f5f5\n[在 X 上关注]: https:\u002F\u002Ftwitter.com\u002Fintent\u002Ffollow?screen_name=TenFramework\n[Discord 徽章]: https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FDiscord-Join%20TEN%20Community-5865F2?style=flat&logo=discord&logoColor=white\n[Discord 邀请链接]: https:\u002F\u002Fdiscord.gg\u002FVnPftUzAMJ\n[LinkedIn 徽章]: https:\u002F\u002Fcustom-icon-badges.demolab.com\u002Fbadge\u002FLinkedIn-TEN_Framework-0A66C2?logo=linkedin-white&logoColor=fff\n[LinkedIn]: https:\u002F\u002Fwww.linkedin.com\u002Fcompany\u002Ften-framework\n[Hugging Face 徽章]: https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FHugging%20Face-TEN%20Framework-yellow?style=flat&logo=huggingface\n[Hugging Face]: https:\u002F\u002Fhuggingface.co\u002FTEN-framework\n[微信徽章]: https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FTEN_Framework-WeChat_Group-%2307C160?logo=wechat&labelColor=darkgreen&color=gray\n[微信讨论]: https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-agent\u002Fdiscussions\u002F170\n\n\u003C!-- 代理示例 -->\n[语音助手图片]: https:\u002F\u002Fgithub.com\u002Fuser-attachments\u002Fassets\u002Fdce3db80-fb48-4e2a-8ac7-33f50bcffa32\n[WebSocket 示例]: ai_agents\u002Fagents\u002Fexamples\u002Fwebsocket-example\n[记忆示例]: ai_agents\u002Fagents\u002Fexamples\u002Fvoice-assistant-with-memU\n[语音助手 VAD 示例]: ai_agents\u002Fagents\u002Fexamples\u002Fvoice-assistant-with-ten-vad\n[语音助手轮次检测示例]: ai_agents\u002Fagents\u002Fexamples\u002Fvoice-assistant-with-turn-detection\n[语音助手示例]: ai_agents\u002Fagents\u002Fexamples\u002Fvoice-assistant\n[浅色分隔线]: https:\u002F\u002Fgithub.com\u002Fuser-attachments\u002Fassets\u002Faec54c94-ced9-4683-ae58-0a5a7ed803bd#gh-light-mode-only\n[深色分隔线]: https:\u002F\u002Fgithub.com\u002Fuser-attachments\u002Fassets\u002Fd57fad08-4f49-4a1c-bdfc-f659a5d86150#gh-dark-mode-only\n[唇形同步图片]: https:\u002F\u002Fgithub.com\u002Fuser-attachments\u002Fassets\u002F51ab1504-b67c-49d4-8a7a-5582d9b254da\n[语音助手 Live2D 示例]: ai_agents\u002Fagents\u002Fexamples\u002Fvoice-assistant-live2d\n[说话人分离图片]: https:\u002F\u002Fgithub.com\u002Fuser-attachments\u002Fassets\u002Ff94b21b8-9dda-4efc-9274-b028cc01296a\n[SpeechMatics 说话人分离示例]: ai_agents\u002Fagents\u002Fexamples\u002Fspeaker-diarization\n[SIP 通话图片]: https:\u002F\u002Fgithub.com\u002Fuser-attachments\u002Fassets\u002F6ed5b04d-945a-4a30-a1cc-f8014b602b38\n[语音助手 SIP 示例]: ai_agents\u002Fagents\u002Fexamples\u002Fvoice-assistant-sip-twilio\n[转录图片]: https:\u002F\u002Fgithub.com\u002Fuser-attachments\u002Fassets\u002Fd793bc6c-c8de-4996-bd85-9ce88c69dd8d\n[转录示例]: ai_agents\u002Fagents\u002Fexamples\u002Ftranscription\n[涂鸦者图片]: https:\u002F\u002Fgithub.com\u002Fuser-attachments\u002Fassets\u002F80c4eabd-de96-4971-8956-6b365d4fbd64\n[涂鸦者示例]: ai_agents\u002Fagents\u002Fexamples\u002Fdoodler\n[ESP32 图片]: https:\u002F\u002Fgithub.com\u002Fuser-attachments\u002Fassets\u002F3d60f1ff-0f82-4fe7-b5c2-ac03d284f60c\n[ESP32 指南]: ai_agents\u002Fesp32-client\n\n\u003C!-- 快速入门 -->\n[agora-app-id]: https:\u002F\u002Fdocs.agora.io\u002Fen\u002Fvideo-calling\u002Fget-started\u002Fmanage-agora-account?platform=web#create-an-agora-project\n[agora-app-certificate]: https:\u002F\u002Fdocs.agora.io\u002Fen\u002Fvideo-calling\u002Fget-started\u002Fmanage-agora-account?platform=web#create-an-agora-project\n[openai-api]: https:\u002F\u002Fopenai.com\u002Findex\u002Fopenai-api\u002F\n[deepgram]: https:\u002F\u002Fdeepgram.com\u002F\n[elevenlabs]: https:\u002F\u002Felevenlabs.io\u002F\n[docker]: https:\u002F\u002Fwww.docker.com\u002F\n[docker-compose]: https:\u002F\u002Fdocs.docker.com\u002Fcompose\u002F\n[nodejs]: https:\u002F\u002Fnodejs.org\u002Fen\n[quick-start-guide-ten-manager]: https:\u002F\u002Ftheten.ai\u002Fdocs\u002Ften_framework\u002Fgetting-started\u002Fquick-start\n[localhost-49483-image]: https:\u002F\u002Fgithub.com\u002Fuser-attachments\u002Fassets\u002F191a7c0a-d8e6-48f9-866f-6a70c58f0118\n[localhost-3000-image]: https:\u002F\u002Fgithub.com\u002Fuser-attachments\u002Fassets\u002F13e482b6-d907-4449-a779-9454bb24c0b1\n[localhost-49483]: http:\u002F\u002Flocalhost:49483\n[localhost-3000]: http:\u002F\u002Flocalhost:3000\n\n\u003C!-- Codespaces -->\n[codespaces-shield]: https:\u002F\u002Fgithub.com\u002Fcodespaces\u002Fbadge.svg\n[codespaces-new]: https:\u002F\u002Fcodespaces.new\u002Ften-framework\u002Ften-agent\n[codespaces-guide]: https:\u002F\u002Ftheten.ai\u002Fdocs\u002Ften_agent_examples\u002Fsetup_development_env\u002Fsetting_up_development_inside_codespace\n\n\u003C!-- 部署 -->\n[vercel]: https:\u002F\u002Fvercel.com\n[netlify]: https:\u002F\u002Fwww.netlify.com\n\n\u003C!-- 敬请期待 -->\n[stay-tuned-image]: https:\u002F\u002Fgithub.com\u002Fuser-attachments\u002Fassets\u002F72c6cc46-a2a2-484d-82a9-f3079269c815\n\n\u003C!-- TEN 生态系统 -->\n[ten-framework-shield]: https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fstars\u002Ften-framework\u002Ften-framework?color=ffcb47&labelColor=gray&style=flat-square&logo=github\n[ten-framework-banner]: https:\u002F\u002Fgithub.com\u002Fuser-attachments\u002Fassets\u002F799584b2-61ff-4255-bdd1-2548d0fdba52\n[ten-framework-link]: https:\u002F\u002Fgithub.com\u002Ften-framework\u002Ften-framework\n\n[ten-vad-link]: https:\u002F\u002Fgithub.com\u002Ften-framework\u002Ften-vad\n[ten-vad-shield]: https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fstars\u002Ften-framework\u002Ften-vad?color=ffcb47&labelColor=gray&style=flat-square&logo=github\n[ten-vad-banner]: https:\u002F\u002Fgithub.com\u002Fuser-attachments\u002Fassets\u002Fe504135e-67fd-4fa1-b0e4-d495358d8aa5\n\n[ten-turn-detection-link]: https:\u002F\u002Fgithub.com\u002Ften-framework\u002Ften-turn-detection\n[ten-turn-detection-shield]: https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fstars\u002Ften-framework\u002Ften-turn-detection?color=ffcb47&labelColor=gray&style=flat-square&logo=github\n[ten-turn-detection-banner]: https:\u002F\u002Fgithub.com\u002Fuser-attachments\u002Fassets\u002Fc72d82cc-3667-496c-8bd6-3d194a91c452\n\n[ten-agent-example-link]: https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Ftree\u002Fmain\u002Fai_agents\u002Fagents\u002Fexamples\n[ten-agent-example-banner]: https:\u002F\u002Fgithub.com\u002Fuser-attachments\u002Fassets\u002F7f735633-c7f6-4432-b6b4-d2a2977ca588\n\n[ten-portal-link]: https:\u002F\u002Fgithub.com\u002Ften-framework\u002Fportal\n[ten-portal-shield]: https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fstars\u002Ften-framework\u002Fportal?color=ffcb47&labelColor=gray&style=flat-square&logo=github\n[ten-portal-banner]: https:\u002F\u002Fgithub.com\u002Fuser-attachments\u002Fassets\u002Ff56c75b9-722c-4156-902d-ae98ce2b3b5e\n\n\u003C!-- 贡献 -->\n[elliotchen200-x]: https:\u002F\u002Fx.com\u002Felliotchen200\n[cyfyifanchen-github]: https:\u002F\u002Fgithub.com\u002Fcyfyifanchen\n[contributors-image]: https:\u002F\u002Fcontrib.rocks\u002Fimage?repo=TEN-framework\u002Ften-framework\n[contribution-guidelines-doc]: .\u002Fdocs\u002Fcode-of-conduct\u002Fcontributing.md\n[license-file]: .\u002FLICENSE\n[third-party-folder]: .\u002Fthird_party\u002F","# TEN Framework 快速上手指南\n\nTEN 是一个用于实时多模态对话式 AI 的开源框架。本指南将帮助你快速在本地运行官方的 Agent 示例（如语音助手）。\n\n## 环境准备\n\n在开始之前，请确保你的开发环境满足以下要求：\n\n### 系统要求\n- **CPU**: >= 2 核\n- **内存**: >= 4 GB\n- **操作系统**: Linux, macOS, 或 Windows (需安装 Docker Desktop)\n\n### 前置依赖\n1. **容器工具**: [Docker](https:\u002F\u002Fwww.docker.com\u002F) 和 [Docker Compose](https:\u002F\u002Fdocs.docker.com\u002Fcompose\u002F)\n   - *国内用户建议*: 配置 Docker 镜像加速器（如阿里云、腾讯云或 DaoCloud 加速器）以加快拉取速度。\n2. **运行时环境**: [Node.js](https:\u002F\u002Fnodejs.org\u002F) (LTS v18 版本)\n3. **API 密钥**: 你需要准备以下服务的密钥：\n   - **Agora (声网)**: App ID 和 App Certificate ([获取链接](https:\u002F\u002Fconsole.agora.io\u002F))\n   - **OpenAI**: API Key ([获取链接](https:\u002F\u002Fplatform.openai.com\u002F))\n   - **Deepgram**: API Key (用于语音转文字) ([获取链接](https:\u002F\u002Fconsole.deepgram.com\u002F))\n   - **ElevenLabs**: API Key (用于文字转语音) ([获取链接](https:\u002F\u002Felevenlabs.io\u002F))\n\n## 安装步骤\n\n### 1. 克隆项目并配置环境变量\n\n首先克隆仓库，进入 `ai_agents` 目录，并基于模板创建 `.env` 文件。\n\n```bash\ngit clone https:\u002F\u002Fgithub.com\u002FTEN-framework\u002FTEN-Agent.git\ncd TEN-Agent\u002Fai_agents\ncp .\u002F.env.example .\u002F.env\n```\n\n### 2. 填写 API 密钥\n\n使用文本编辑器打开 `.env` 文件，填入你在“环境准备”阶段获取的密钥：\n\n```bash\nAGORA_APP_ID=你的_Agora_App_ID\nAGORA_APP_CERTIFICATE=你的_Agora_App_Certificate\n\n# Deepgram (语音转文字必填)\nDEEPGRAM_API_KEY=你的_Deepgram_Key\n\n# OpenAI (大语言模型必填)\nOPENAI_API_KEY=你的_OpenAI_Key\n\n# ElevenLabs (文字转语音必填)\nELEVENLABS_TTS_KEY=你的_ElevenLabs_Key\n```\n\n### 3. 启动开发容器\n\n使用 Docker Compose 启动后端服务容器：\n\n```bash\ndocker compose up -d\n```\n\n### 4. 进入容器并构建示例\n\n进入名为 `ten_agent_dev` 的容器内部：\n\n```bash\ndocker exec -it ten_agent_dev bash\n```\n\n在容器内，选择一个示例项目进行构建。这里以“链式语音助手”为例：\n\n```bash\n# 进入示例目录\ncd agents\u002Fexamples\u002Fvoice-assistant\n\n# 安装依赖并运行 (如果是首次运行或修改了代码)\ntask install\ntask run\n```\n*注：构建过程可能需要 5-8 分钟，具体取决于网络状况。*\n\n## 基本使用\n\n当终端显示服务启动成功后，你可以通过浏览器访问以下界面：\n\n1. **TEN Manager (配置中心)**\n   - 地址：[http:\u002F\u002Flocalhost:49483](http:\u002F\u002Flocalhost:49483)\n   - **操作**: 在此页面右键点击 STT (语音识别)、LLM (大模型) 和 TTS (语音合成) 组件，打开属性面板确认 API Key 已正确加载。如有变动可在此提交更新。\n\n2. **Agent Examples UI (交互界面)**\n   - 地址：[http:\u002F\u002Flocalhost:3000](http:\u002F\u002Flocalhost:3000)\n   - **操作**: 点击页面上的麦克风图标或输入框，即可开始与 AI 进行实时语音或文字对话。\n\n### 替代方案：无 Docker 运行 (Beta)\n如果你不想使用 Docker，TEN 也支持通过 TEN Manager 直接运行转录应用，具体可参考官方提供的 [TEN Manager 快速指南](https:\u002F\u002Fdocs.theten.ai\u002F)。\n\n### 替代方案：GitHub Codespaces\n如果本地环境配置困难，你可以直接使用 GitHub Codespaces 在线运行，无需本地安装 Docker：\n[![在 Codespaces 中打开](https:\u002F\u002Fgithub.com\u002Fcodespaces\u002Fbadge.svg)](https:\u002F\u002Fcodespaces.new\u002FTEN-framework\u002FTEN-Agent)","某初创团队正在开发一款面向儿童的交互式绘本伴读应用，需要实现低延迟的语音对话与实时表情同步功能。\n\n### 没有 ten-framework 时\n- **开发周期漫长**：团队需分别集成语音识别、大模型推理、语音合成及唇形同步模块，各组件接口不一，联调耗时数周。\n- **对话体验割裂**：由于缺乏统一的流式处理机制，用户说完话后需等待 2-3 秒才能听到回复，严重打断儿童沉浸感。\n- **多模态同步困难**：语音输出与虚拟角色的口型、动作难以精准对齐，导致“音画不同步”，显得角色僵硬虚假。\n- **运维成本高昂**：自行搭建高并发实时服务架构复杂，稳定性差，稍有流量波动便出现延迟飙升或服务崩溃。\n\n### 使用 ten-framework 后\n- **快速原型落地**：利用框架预置的多模态代理模板，团队在 3 天内即完成了从语音输入到动画输出的全链路打通。\n- **极致流畅交互**：依托其原生支持的实时流式传输，端到端延迟降低至毫秒级，实现了如真人般自然的即时对答。\n- **自动多模态对齐**：内置的唇形同步（Lip Sync）扩展自动将音频流映射为角色动作，确保声音与画面完美契合。\n- **弹性稳定部署**：基于框架标准化的容器化部署方案，系统轻松应对高峰流量，无需额外投入大量运维精力。\n\nten-framework 通过一站式解决实时多模态交互的技术碎片化难题，让开发者能专注于业务创新而非底层基建。","https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FTEN-framework_ten-framework_627ba5e7.png","TEN-framework","TEN framework","https:\u002F\u002Foss.gittoolsai.com\u002Favatars\u002FTEN-framework_23fbc0fc.png","",null,"https:\u002F\u002Fgithub.com\u002FTEN-framework",[82,86,90,94,98,102,106,110,114,118],{"name":83,"color":84,"percentage":85},"Python","#3572A5",31.6,{"name":87,"color":88,"percentage":89},"C","#555555",22.5,{"name":91,"color":92,"percentage":93},"C++","#f34b7d",15.6,{"name":95,"color":96,"percentage":97},"TypeScript","#3178c6",13.1,{"name":99,"color":100,"percentage":101},"Rust","#dea584",11.7,{"name":103,"color":104,"percentage":105},"Go","#00ADD8",3.1,{"name":107,"color":108,"percentage":109},"Shell","#89e051",0.9,{"name":111,"color":112,"percentage":113},"Dockerfile","#384d54",0.4,{"name":115,"color":116,"percentage":117},"CSS","#663399",0.3,{"name":119,"color":120,"percentage":117},"HTML","#e34c26",10388,1249,"2026-04-02T23:14:36","NOASSERTION",4,"Linux, macOS, Windows","未说明","最低 4GB",{"notes":130,"python":127,"dependencies":131},"该工具主要基于 Docker 容器化部署，本地运行需安装 Docker 和 Node.js v18。最低系统要求为 2 核 CPU 和 4GB 内存。支持在 GitHub Codespaces 中运行而无需本地安装 Docker。需要配置 Agora、OpenAI、Deepgram 和 ElevenLabs 的 API 密钥。",[132,133,134],"Docker","Docker Compose","Node.js (LTS) v18",[15,13,14,55,52],[137,138,139,140,141],"ai","multi-modal","real-time","video","voice",7,"2026-03-27T02:49:30.150509","2026-04-06T05:16:02.130379",[],[147,152,157,162,167,172,177,182,187,192,197,202,207,212,217,222,227,232,237,242],{"id":148,"version":149,"summary_zh":150,"released_at":151},55277,"0.11.63","## 变更内容\n* 修复：由 @sunxilin 在 https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F2108 中修复 Azure ASR 相关问题。\n* 杂项：由 @diyuyi-agora 在 https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F2110 中将版本号升级至 0.4.4，并增强 WebSocket 的异常处理。\n* 修复：由 @YiminW 在 https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F2115 中修复腾讯 TTS 导致 CPU 长时间占用的问题。\n* 测试：由 @YiminW 在 https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F2102 中为 TTS 保护器添加空输入测试，以验证 tts_audio_end 事件。\n* 新特性：由 @zshbleaker 在 https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F2109 中新增 Oracle Speech AI 的 ASR 和 TTS 功能。\n* 修复：由 @sunxilin 在 https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F2117 中修复 ASR 保护器相关问题。\n* 修复：由 @KKKPJSKEY 在 https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F2077 中再次修复 Querit 插件的代码审查缺陷。\n* 新特性（扩展）：由 @nguyenhuy1431997 在 https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F2052 中新增 Blaze STT 和 TTS 扩展。\n* 新特性：由 @zshbleaker 在 https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F2120 中将 Oracle 私钥文件转换为 Base64 字符串。\n* 新特性：由 @YiminW 在 https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F2122 中增加 TTS 输出文本和音频的指标统计。\n* 新特性：由 @YiminW 在 https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F2124 中为腾讯 TTS 添加指标统计。\n* 新特性：由 @YiminW 在 https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F2121 中支持 Cartesia 的词级别输出，并为部分 TTS 增加指标统计。\n* 修复：由 @zshbleaker 在 https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F2123 中修复 Oracle ASR 时间戳未解析的问题。\n* 杂项：由 @sunxilin 在 https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F2125 中为 Python 绑定添加更多日志记录。\n* 将所有 Python 集成测试的版本号升级至 0.11.63，并更新…由 @halajohn 在 https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F2126 中完成。\n\n## 新贡献者\n* @zshbleaker 在 https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F2109 中完成了首次贡献。\n* @nguyenhuy1431997 在 https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F2052 中完成了首次贡献。\n\n**完整变更日志**：https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fcompare\u002F0.11.62...0.11.63","2026-04-02T14:37:25",{"id":153,"version":154,"summary_zh":155,"released_at":156},55278,"0.11.62","## 变更内容\n* 修复（TEN-5752）：支持 holding_mode，由 @diyuyi-agora 在 https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F2101 中实现\n* 修复：生命周期问题，由 @sunxilin 在 https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F2104 中修复\n* Chrome：升级至 0.11.62 版本，由 @halajohn 在 https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F2105 中完成\n\n\n**完整变更日志**：https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fcompare\u002F0.11.61...0.11.62","2026-03-14T04:57:39",{"id":158,"version":159,"summary_zh":160,"released_at":161},55279,"0.11.61","## 变更内容\n* 修复：@sunxilin 在 https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F2099 中修复了 TEN_ASSERT 中的 dprintf 调用。\n* 杂项：@halajohn 在 https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F2103 中将版本号更新至 0.11.61。\n\n\n**完整变更日志**：https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fcompare\u002F0.11.60...0.11.61","2026-03-12T02:26:01",{"id":163,"version":164,"summary_zh":165,"released_at":166},55280,"0.11.60","## 变更内容\n* 功能新增：@liaochenliang 在 https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F2088 中添加了 Deepgram ASR 流模型\n* 功能新增：@sunxilin 在 https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F2097 中支持在图中使用 sync_stop_before_deinit\n* 重构\u002F维护：@halajohn 在 https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F2098 中将版本号升级至 0.11.60\n\n\n**完整变更日志**：https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fcompare\u002F0.11.59...0.11.60","2026-03-10T10:45:38",{"id":168,"version":169,"summary_zh":170,"released_at":171},55281,"0.11.59","## 变更内容\n* 修复：@FaithfulinLOVE 在 https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F2092 中修复了 Windows 上的示例代码问题。\n* 版本升级至 0.11.59：在多个 Python 集成测试中进行了版本更新，等等。由 @halajohn 在 https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F2095 中完成。\n\n\n**完整变更日志**：https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fcompare\u002F0.11.58...0.11.59","2026-03-07T06:27:46",{"id":173,"version":174,"summary_zh":175,"released_at":176},55282,"0.11.58","## 变更内容\n* 杂项：由 @Vackwin 在 https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F2091 中将版本更新至 0.1.1\n* 修复：由 @FaithfulinLOVE 在 https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F2093 中修复发布逻辑\n* 杂项：由 @halajohn 在 https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F2094 中将版本更新至 0.11.58\n\n\n**完整变更日志**：https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fcompare\u002F0.11.57...0.11.58","2026-03-06T12:58:25",{"id":178,"version":179,"summary_zh":180,"released_at":181},55283,"0.11.57","## 变更内容\n* 修复：在 finally 块中调用 disconnect 回调，由 @diyuyi-agora 在 https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F2085 中完成\n* 修复：复制导入库的工作流，由 @FaithfulinLOVE 在 https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F2087 中完成\n* 杂项：为示例添加英文文档，由 @FaithfulinLOVE 在 https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F2086 中完成\n* 杂项：将版本更新至 0.11.57，由 @halajohn 在 https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F2089 中完成\n\n\n**完整变更日志**：https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fcompare\u002F0.11.56...0.11.57","2026-03-05T13:08:02",{"id":183,"version":184,"summary_zh":185,"released_at":186},55284,"0.11.56","## 变更内容\n* 修复：支持通过 advanced_params_json 设置 AZURE_LANGUAGE_ID_MODE_KEY，由 @diyuyi-agora 在 https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F2071 中完成\n* 修复（anam_avatar_python）：通过配置处理 Vercel 绕过令牌，由 @RinZ27 在 https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F2055 中完成\n* 修复：避免腾讯云重连并占用 CPU，由 @YiminW 在 https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F2060 中完成\n* 新增功能：为 Querit ASR 服务添加 queritsearch_tool_python，由 @KKKPJSKEY 在 https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F2066 中完成\n* 新增功能：更新 Cartesia TTS 版本以保持 SDK 兼容性，由 @YiminW 在 https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F2075 中完成\n* 修复：Querit 插件代码审查中的错误，由 @KKKPJSKEY 在 https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F2073 中完成\n* 修复：Rime TTS 修复上下文 ID 问题，由 @YiminW 在 https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F2072 中完成\n* 新增功能：在 Windows 上提供快速入门演示，由 @FaithfulinLOVE 在 https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F2076 中完成\n* 更新 Chrore 版本至 0.11.56，由 @halajohn 在 https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F2084 中完成\n\n## 新贡献者\n* @RinZ27 在 https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F2055 中完成了首次贡献\n* @KKKPJSKEY 在 https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F2066 中完成了首次贡献\n\n**完整变更日志**：https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fcompare\u002F0.11.55...0.11.56","2026-03-04T02:39:42",{"id":188,"version":189,"summary_zh":190,"released_at":191},55285,"0.11.55","## 变更内容\n* 功能：新增对实时 GPT 1.5 的支持，由 @plutoless 在 https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F2065 中实现。\n* 功能：在 Azure ASR 扩展中启用连续语言识别功能，由 @diyuyi-agora 在 https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F2067 中实现。\n* 功能：将 Windows 软件包发布到注册表，由 @FaithfulinLOVE 在 https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F2062 中实现。\n* 修复：将测试应用的属性设置为空，由 @sunxilin 在 https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F2068 中实现。\n* 版本升级：将所有 Python 集成测试的版本号升级至 0.11.55，并更新安装脚本，由 @halajohn 在 https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F2069 中完成。\n* 杂项：移除 esp32-camera 子项目，由 @halajohn 在 https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F2070 中完成。\n\n\n**完整变更日志**：https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fcompare\u002F0.11.54...0.11.55","2026-02-27T10:17:44",{"id":193,"version":194,"summary_zh":195,"released_at":196},55286,"0.11.54","## 变更内容\n* 由 @qiuyanli1990 在 https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F2025 中重新组织 esp32-client\n* 修复：移除子模块 ai_agents\u002Fesp32-client\u002Fcomponents\u002Fesp32-camera，由 @FaithfulinLOVE 在 https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F2036 中完成\n* 新增功能：msvc-go，由 @FaithfulinLOVE 在 https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F2031 中实现\n* 新增功能：使用 faster-whisper 添加 whisper STT 扩展，由 @Nsuccess 在 https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F1984 中完成\n* 修复：修复 pylint 问题，由 @plutoless 在 https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F2039 中解决\n* 新增功能：添加 Sarvam ASR 扩展并更新配置，由 @nitin4real 在 https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F2041 中实现\n* 新增功能：添加 TTS 代理以将请求转发至 OpenAI TTS 服务器，由 @YiminW 在 https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F2030 中完成\n* 修复：移除代理扩展测试后的“.ten”后缀，由 @sunxilin 在 https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F2044 中完成\n* 修复（TEN-5338）：将采样率发送至服务器，由 @YiminW 在 https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F2040 中完成\n* 将 cartesia 包版本固定为 2.0.15，由 @plutoless 在 https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F2050 中完成\n* 新增功能：添加带有 EverMemOS 内存集成的 voice-assistant-with-EverMemOS 示例，由 @AI-J-IN 在 https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F2047 中实现\n* 修复：修复 rime TTS WebSocket 版本的 TTFB 计算问题，由 @YiminW 在 https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F2049 中完成\n* 添加 ESP32 ADF 子模块分支信息，由 @harold-2022-cloud 在 https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F2042 中完成\n* 新增功能：支持 openclaw 使用场景，由 @plutoless 在 https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F2035 中实现\n* 新增功能\u002Fopenclaw，由 @plutoless 在 https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F2053 中完成\n* 修复：修复 minimax 推理格式问题，由 @plutoless 在 https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F2054 中解决\n* 新增功能：将 Telnyx 添加为语音助手的电话服务提供商，由 @a692570 在 https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F2046 中完成\n* 新增功能（ai_agents）：添加 Plivo SIP 电话集成，由 @navi- 在 https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F2020 中完成\n* 新增功能：在演示中支持 minimax M2.5 高速模型，由 @plutoless 在 https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F2056 中实现\n* 修复 ezai ASR 最终处理问题，由 @Vackwin 在 https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F2051 中完成\n* 修复：更新 llvm 包的名称，因为它们已被重构，由 @FaithfulinLOVE 在 https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F2059 中完成\n* 新增功能：支持设备身份配对，由 @plutoless 在 https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F2061 中实现\n* 新增功能：Windows Node.js 支持，由 @FaithfulinLOVE 在 https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F2048 中完成\n* 将版本从 0.11.53 升级到 0.11.54，并在多个 Python 集成测试清单中进行更新，同时更新安装脚本以反映新的默认版本。由 @halajohn 在 https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F2063 中完成\n\n## ","2026-02-25T08:44:44",{"id":198,"version":199,"summary_zh":200,"released_at":201},55287,"0.11.53","## What's Changed\r\n* docs: removing hackathon info by @cyfyifanchen in https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F2015\r\n* feat: add qwen3 tts by @cyfyifanchen in https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F2019\r\n* feat: openai_tts2 changed for normal tts server by @YiminW in https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F2018\r\n* fix: mingw python tests debug by @FaithfulinLOVE in https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F2017\r\n* fix(soniox): count sent silence duration in finalize api by @anexpn in https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F2024\r\n* refactor:  connection handling in Bytedance ASR extension and Volcengine ASR client by @diyuyi-agora in https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F2023\r\n* fix: fix playground issue by @plutoless in https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F2032\r\n* #2014 docs(voice-assistant): 重构README，详细说明PowerMem记忆功能 by @flying-dragon-ai in https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F2028\r\n* fix(TEN-5246): openai asr rename websocket_base_url to base_url by @diyuyi-agora in https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F2033\r\n* Bump version to 0.11.53 across all Python integration tests and update install script by @halajohn in https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F2034\r\n\r\n## New Contributors\r\n* @flying-dragon-ai made their first contribution in https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F2028\r\n\r\n**Full Changelog**: https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fcompare\u002F0.11.52...0.11.53","2026-02-04T07:30:47",{"id":203,"version":204,"summary_zh":205,"released_at":206},55288,"0.11.52","## What's Changed\r\n* feat: add doodler a doodle board for kids by @cyfyifanchen in https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F1892\r\n* docs: fix speaker diarization image link by @cyfyifanchen in https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F1976\r\n* docs: add doodler banner image and link in readme by @cyfyifanchen in https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F1990\r\n* fix: fix 5 go tests on win with mingw by @FaithfulinLOVE in https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F1987\r\n* fix: update vendor references to use dynamic vendor method and bump version to 0.3.13 by @diyuyi-agora in https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F1991\r\n* docs: add break line character by @cyfyifanchen in https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F1992\r\n* fix(Dockerfile): correct USE_AGENT value for doodler example by @cyfyifanchen in https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F1993\r\n* fix: update error handling logic for reconnection attempts by @diyuyi-agora in https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F1978\r\n* fix: always send asr error when error_handler by @diyuyi-agora in https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F1996\r\n* feat: add Murf TTS extension by @nitin4real in https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F1989\r\n* feat: add elevenlabs scribe v2 by @cyfyifanchen in https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F1995\r\n* docs: add doodler section in all readme by @cyfyifanchen in https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F1997\r\n* style: add updated ux to better support color section and ereasing by @cyfyifanchen in https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F1999\r\n* fix: deepgram asr config by @liaochenliang in https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F2000\r\n* refactor: refactored all the frontend to use the root biome by @cyfyifanchen in https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F1891\r\n* chore: bump version to 0.3.16 by @diyuyi-agora in https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F2001\r\n* feat: Add NVIDIA Riva TTS extension (#1964) by @Nsuccess in https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F1982\r\n* fix: fix folder path of nvidia ext by @plutoless in https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F2005\r\n* fix: reformat nvidia_riva_tts_python by @anexpn in https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F2008\r\n* feat: add inworld tts by @cyfyifanchen in https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F2010\r\n* feat(soniox): add optional silence packets in default finalize mode by @anexpn in https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F2007\r\n* feat(soniox): add finalize mode by closing connection by @anexpn in https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F2006\r\n* chore(soniox): bump version to 0.3.10 by @anexpn in https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F2011\r\n* feat: mingw python (new) by @FaithfulinLOVE in https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F2009\r\n* feat: support graph test in python by @sunxilin in https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F2012\r\n* fix: log emitted to otlp by @sunxilin in https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F2003\r\n* Bump version to 0.11.52 across all Python integration manifests and update install script defaults by @halajohn in https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F2016\r\n\r\n## New Contributors\r\n* @Nsuccess made their first contribution in https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F1982\r\n\r\n**Full Changelog**: https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fcompare\u002F0.11.51...0.11.52","2026-01-23T07:32:30",{"id":208,"version":209,"summary_zh":210,"released_at":211},55289,"0.11.51","## What's Changed\r\n* refactor(agent-prompts): update character prompts by @cyfyifanchen in https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F1954\r\n* feat: add connection delay metric for soniox by @anexpn in https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F1949\r\n* docs(ai_agents): consolidate documentation into agents md by @cyfyifanchen in https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F1951\r\n* feat: deepgram asr webscoket by @liaochenliang in https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F1918\r\n* fix: azure asr fatal error by @sunxilin in https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F1946\r\n* refactor: enhance metadata handling in BytedanceASRLLMExtension by @diyuyi-agora in https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F1955\r\n* docs: update terminology from speech to speaker diarization by @cyfyifanchen in https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F1952\r\n* chore: debug cpp integration tests when compiled with mingw by @FaithfulinLOVE in https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F1944\r\n* feat: expose confidence of soniox tokens by @anexpn in https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F1956\r\n* refactor: rename speechmatics diarization to speaker diarization by @cyfyifanchen in https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F1957\r\n* feat: support tman check interface subcommand by @sunxilin in https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F1971\r\n* feat: support log with fields by @sunxilin in https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F1945\r\n* feat: add conversation recorder extension by @Roei-Bracha in https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F1950\r\n* docs: update readme add event info by @lingogom in https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F1975\r\n* fix: deepgram asr reconnect by @liaochenliang in https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F1977\r\n* feat: track  last_transcript_id as translation id by @diyuyi-agora in https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F1979\r\n* fix: tencent asr by @sunxilin in https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F1980\r\n* feat: mingw enabling go binding by @FaithfulinLOVE in https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F1972\r\n* fix: fixed most go tests for them to run successfully on windows with mingw by @FaithfulinLOVE in https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F1981\r\n* fix: protect program from panic if log failed by @sunxilin in https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F1974\r\n* fix: log category by @sunxilin in https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F1985\r\n* Bump version to 0.11.51 across multiple Python integration tests and update install script by @halajohn in https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F1986\r\n\r\n## New Contributors\r\n* @diyuyi-agora made their first contribution in https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F1955\r\n* @lingogom made their first contribution in https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F1975\r\n\r\n**Full Changelog**: https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fcompare\u002F0.11.50...0.11.51","2026-01-15T06:55:35",{"id":213,"version":214,"summary_zh":215,"released_at":216},55290,"0.11.50","## What's Changed\r\n* refactor: msgpack by @FaithfulinLOVE in https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F1938\r\n* fix(property.json): update assistant prompts and fix JSON formatting by @cyfyifanchen in https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F1943\r\n* fix: print to stderr if log is not initialized by @sunxilin in https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F1942\r\n* feat: add voice assistant besed on ws quick-start doc by @sunxilin in https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F1939\r\n* chore: update version numbers in various manifest and header files ac… by @halajohn in https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F1948\r\n\r\n\r\n**Full Changelog**: https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fcompare\u002F0.11.49...0.11.50","2026-01-06T10:42:48",{"id":218,"version":219,"summary_zh":220,"released_at":221},55291,"0.11.49","## What's Changed\r\n* fix: fix the ui side effect from heygen and anam by @cyfyifanchen in https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F1919\r\n* feat: update build image to 0.7.14 by @plutoless in https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F1935\r\n* feat: mingw clean with yml by @FaithfulinLOVE in https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F1934\r\n* feat: support emit log to opentelemetry by @sunxilin in https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F1925\r\n* fix: refine reconnect strategy in azure asr extension by @sunxilin in https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F1927\r\n* fix: test case by @sunxilin in https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F1936\r\n* chore: update version numbers in various manifest files and header files across multiple languages by @halajohn in https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F1937\r\n\r\n\r\n**Full Changelog**: https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fcompare\u002F0.11.48...0.11.49","2026-01-04T05:51:55",{"id":223,"version":224,"summary_zh":225,"released_at":226},55292,"0.11.48","## What's Changed\r\n* fix: catch BaseException in Python async extensions by @sunxilin in https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F1921\r\n* feat: support adding description in manifest api and interface json files by @sunxilin in https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F1917\r\n* feat: add dump_rotate_on_finalize and enable_keepalive configs for soniox by @anexpn in https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F1928\r\n* feat: feat: enhance Bytedance ASR configuration and processing by @hanhandi-git in https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F1855\r\n* chore: update linux ARM64 workflow to use ubuntu-24.04-arm and streamline build steps by @halajohn in https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F1924\r\n* chore: modify rust tool chain version by @FaithfulinLOVE in https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F1923\r\n* fix: tman install in lock mode by @sunxilin in https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F1929\r\n* chore: update version numbers in various manifest files and header files across multiple languages by @halajohn in https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F1930\r\n* fix: ci fail by @sunxilin in https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F1931\r\n* fix: ci by @sunxilin in https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F1932\r\n\r\n## New Contributors\r\n* @hanhandi-git made their first contribution in https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F1855\r\n\r\n**Full Changelog**: https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fcompare\u002F0.11.47...0.11.48","2025-12-31T08:44:58",{"id":228,"version":229,"summary_zh":230,"released_at":231},55293,"0.11.47","## What's Changed\r\n* chore: update version number by @halajohn in https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F1906\r\n* docs: clarify Apache License terms in README by @halajohn in https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F1908\r\n* feat: add graph per character for live2d by @cyfyifanchen in https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F1910\r\n* feat: add microsoft vibevoice websocket extension by @cyfyifanchen in https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F1905\r\n* fix: undefined behavior if build without rust by @sunxilin in https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F1915\r\n* refactor: pass runtime info as params by @FaithfulinLOVE in https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F1914\r\n* fix: python test case & improve the user experience of TenError in Python by @sunxilin in https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F1912\r\n* fix: remove the default signal handler in nodejs addon loader by @sunxilin in https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F1913\r\n* feat: fully utilize uv in ten framework by @sunxilin in https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F1904\r\n* chore: update version numbers across various manifests and header files by @halajohn in https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F1920\r\n\r\n\r\n**Full Changelog**: https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fcompare\u002F0.11.46...0.11.47","2025-12-24T09:04:40",{"id":233,"version":234,"summary_zh":235,"released_at":236},55294,"0.11.46","## What's Changed\r\n* Feat\u002Ftranscript toggle by @plutoless in https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F1885\r\n* feat: update cosy voice tts version number by @cyfyifanchen in https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F1890\r\n* fix: improve avatar voice_end timing and deepgram reliability by @BenWeekes in https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F1882\r\n* feat: change the default model to gemini three flash by @cyfyifanchen in https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F1895\r\n* feat: add hellos graph and share code between thymia analysis modes by @BenWeekes in https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F1883\r\n* feat: sarvam asr by @nitin4real in https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F1896\r\n* feat: add voice assistant example with PowerMem integration by @HuXin0817 in https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F1865\r\n* fix: coveralls remove container for all test jobs by @FaithfulinLOVE in https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F1878\r\n* docs: Update database name in README for PowerMem by @HuXin0817 in https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F1898\r\n* fix: correct audio start_ms handling by @nitin4real in https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F1901\r\n* feat: support tman install --locked & support tracing tman by @sunxilin in https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F1888\r\n* feat: support opentelemetry by @sunxilin in https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F1862\r\n* refactor: update from_utf8_lossy to String::from_utf8_lossy in PtyMessage formatting by @halajohn in https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F1902\r\n* chore: update version number by @halajohn in https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F1903\r\n\r\n## New Contributors\r\n* @BenWeekes made their first contribution in https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F1882\r\n* @HuXin0817 made their first contribution in https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F1865\r\n\r\n**Full Changelog**: https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fcompare\u002F0.11.45...0.11.46","2025-12-21T08:20:51",{"id":238,"version":239,"summary_zh":240,"released_at":241},55295,"0.11.45","## What's Changed\r\n* feat: change default tts in live2d from 11labs to minimax by @cyfyifanchen in https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F1868\r\n* fix: remove duplicate upload of tman-win zip by @FaithfulinLOVE in https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F1879\r\n* fix: refine example app and install tgn with latest version by @sunxilin in https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F1880\r\n* feat: add voice id greeting and languages by @cyfyifanchen in https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F1873\r\n* feat: add tman coverage into coveralls by @FaithfulinLOVE in https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F1870\r\n* feat: move docs to ten-framework and add workflow to protect onboarding experience by @sunxilin in https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F1881\r\n* feat: add gemini pro and flash tts by @cyfyifanchen in https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F1872\r\n* chore: update version headers and manifest files across various languages and extensions by @halajohn in https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F1886\r\n* chore: add portal target metadata to extension development guides in Chinese and English by @halajohn in https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F1887\r\n\r\n\r\n**Full Changelog**: https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fcompare\u002F0.11.44...0.11.45","2025-12-16T06:03:30",{"id":243,"version":244,"summary_zh":245,"released_at":246},55296,"0.11.44","## What's Changed\r\n* chore: update doc by @sunxilin in https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F1874\r\n* chore: remove outdated documentation files AI_working_with_ten.md and AI_working_with_ten_compact.md by @halajohn in https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F1875\r\n* chore: update version headers and manifest files across various languages and extensions by @halajohn in https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fpull\u002F1876\r\n\r\n\r\n**Full Changelog**: https:\u002F\u002Fgithub.com\u002FTEN-framework\u002Ften-framework\u002Fcompare\u002F0.11.43...0.11.44","2025-12-15T03:56:51"]