shelfry.app/p/xiaozhi-esp32-server

xiaozhi-esp32-server

这是开源硬件项目 xiaozhi-esp32 的后端服务，用 Python、Java 和 Vue 实现了 MQTT+UDP 网关、WebSocket 与 HTTP 服务，让用户不必依赖他人搭好的公共服务器，自行部署一套完整的语音助手后端。它把语音识别、大模型对话、语音合成和视觉理解串联成流式链路，并支持声纹识别、短期或外部记忆、RAGFlow 知识库、MCP 工具调用与 MQTT 指令下发。配套的 Web 智控台可管理设备、用户与模型配置，所有语音和大模型组件都通过插件化配置切换，可选用免费方案或低延迟的流式付费接口。提供最简化与全模块两种部署形态，支持 Docker 和源码运行。

WebMCP Server MIT

访问官网 GitHub

Stars

10.9K

Forks

3.7K

语言

JavaScript

小智后端服务xiaozhi-esp32-server

本项目基于人机共生智能理论和技术研发智能终端软硬件体系为开源智能硬件项目 xiaozhi-esp32提供后端服务

根据小智通信协议使用Python、Java、Vue实现

支持MQTT+UDP协议、Websocket协议、MCP接入点、声纹识别、知识库

常见问题 · 反馈问题 · 部署文档 · 更新日志

![Tiếng Việt](https://img.shields.io/badge/Tiếng Việt-DFE0E5 "os:x|center") ![Português (Brasil)](https://img.shields.io/badge/Português (Brasil)-DFE0E5 "os:x|center")

Spearheaded by Professor Siyuan Liu's Team (South China University of Technology)

刘思源教授团队主导研发（华南理工大学）

本项目需要配合 ESP32 硬件设备使用。如果您已经购买了 ESP32 相关硬件，且成功对接过虾哥部署的后端服务，并希望独立搭建自己的 xiaozhi-esp32 后端服务，那么本项目非常适合您。

想看使用效果？请猛戳视频 🎥

  [![响应速度感受](docs/images/demo9.png)](https://www.bilibili.com/video/BV1FMFyejExX)




  [![速度优化秘诀](docs/images/demo6.png)](https://www.bilibili.com/video/BV1vchQzaEse)




  [![小智数字人 支持语音唤醒](docs/images/demo8.png)](https://www.bilibili.com/video/BV1WEcxzFEAT)




  [![设备呼叫设备，打电话](docs/images/demo0.png)](https://www.bilibili.com/video/BV1CKVz6UEuB)




  [![复杂医疗场景](docs/images/demo1.png)](https://www.bilibili.com/video/BV1C1tCzUEZh)








  [![播放音乐查询天气播报新闻](docs/images/demo7.png)](https://www.bilibili.com/video/BV1VC96Y5EMH)




  [![实时打断](docs/images/demo10.png)](https://www.bilibili.com/video/BV12J7WzBEaH)




  [![拍照识物品](docs/images/demo12.png)](https://www.bilibili.com/video/BV1Co76z7EvK)




  [![控制家电开关](docs/images/demo5.png)](https://www.bilibili.com/video/BV1pNXWYGEx1)




  [![多指令任务](docs/images/demo11.png)](https://www.bilibili.com/video/BV1TJ7WzzEo6)








  [![MCP接入点](docs/images/demo13.png)](https://www.bilibili.com/video/BV1ZQKUzYExM)




  [![MQTT指令下发](docs/images/demo4.png)](https://www.bilibili.com/video/BV1zUW5zJEkq)




  [![声纹识别](docs/images/demo14.png)](https://www.bilibili.com/video/BV1Exu3zqEDe)




  [![自定义音色](docs/images/demo2.png)](https://www.bilibili.com/video/BV1CDKWemEU6)




  [![使用粤语交流](docs/images/demo3.png)](https://www.bilibili.com/video/BV12yA2egEaC)

1、本项目为开源软件，本软件与对接的任何第三方API服务商（包括但不限于语音识别、大模型、语音合成等平台）均不存在商业合作关系，不为其服务质量及资金安全提供任何形式的担保。建议使用者优先选择持有相关业务牌照的服务商，并仔细阅读其服务协议及隐私政策。本软件不托管任何账户密钥、不参与资金流转、不承担充值资金损失风险。

2、本项目功能未完善，且未通过网络安全测评，请勿在生产环境中使用。如果您在公网环境中部署学习本项目，请务必做好必要的防护。

本项目提供两种部署方式，请根据您的具体需求选择：

🚀 部署方式选择

部署方式	特点	适用场景	部署文档	配置要求	视频教程
最简化安装	智能对话、单智能体管理	低配置环境，数据存储在配置文件，无需数据库	①Docker版 / ②源码部署	如果使用`FunASR`要2核4G，如果全API，要2核2G	-
全模块安装	智能对话、多用户管理、多智能体管理、智控台界面操作	完整功能体验，数据存储在数据库	①Docker版 / ②源码部署 / ③源码部署自动更新教程	如果使用`FunASR`要4核8G，如果全API，要2核4G	本地源码启动视频教程

常见问题及相关教程，可参考这个链接

💡 提示：以下是按最新代码部署后的测试平台，有需要可烧录测试，并发为6个，每天会清空数据，

智控台地址: https://2662r3426b.vicp.fun
智控台(h5版): https://2662r3426b.vicp.fun/h5/index.html

服务测试工具： https://2662r3426b.vicp.fun/test/
OTA接口地址: https://2662r3426b.vicp.fun/xiaozhi/ota/
Websocket接口地址: wss://2662r3426b.vicp.fun/xiaozhi/v1/

🚩 配置说明和推荐

[!Note] 本项目提供两种配置方案：

入门全免费配置：适合个人家庭使用，所有组件均采用免费方案，无需额外付费。

流式配置：适合演示、培训、超过2个并发等场景，采用流式处理技术，响应速度更快，体验更佳。

自0.5.2版本起，项目支持流式配置，相比早期版本，响应速度提升约2.5秒，显著改善用户体验。

模块名称	入门全免费设置	流式配置
ASR(语音识别)	FunASR(本地)	👍XunfeiStreamASR(讯飞流式)
LLM(大模型)	glm-4-flash(智谱)	👍qwen-flash(阿里百炼)
VLLM(视觉大模型)	glm-4v-flash(智谱)	👍qwen3.5-flash(阿里百炼)
TTS(语音合成)	EdgeTTS(微软)	👍HuoshanDoubleStreamTTS(火山流式)
Intent(意图识别)	function_call(函数调用)	function_call(函数调用)
Memory(记忆功能)	mem_local_short(本地短期记忆）	mem_local_short（本地短期记忆）

如果您关心各组件的耗时，请查阅小智各组件性能测试报告，可按报告中的测试方法在您的环境中实际测试。

本项目提供以下测试工具，帮助您验证系统和选择合适的模型：

工具名称	位置	使用方法	功能说明
音频交互测试工具	main》digital-human》index.html	在 `main/digital-human` 执行 `python start.py` 后访问 `http://127.0.0.1:8006/index.html`	测试音频播放和接收功能，验证Python端音频处理是否正常
模型响应测试工具	main》xiaozhi-server》performance_tester.py	执行 `python performance_tester.py`	测试ASR(语音识别)、LLM(大模型)、VLLM(视觉模型)、TTS(语音合成)三个核心模块的响应速度

💡 提示：测试模型速度时，只会测试配置了密钥的模型。

功能模块	描述
核心架构	基于MQTT+UDP网关、WebSocket、HTTP服务器，提供完整的控制台管理和认证系统
语音交互	支持流式ASR(语音识别)、流式TTS(语音合成)、VAD(语音活动检测)，支持多语言识别和语音处理
声纹识别	支持多用户声纹注册、管理和识别，与ASR并行处理，实时识别说话人身份并传递给LLM进行个性化回应
智能对话	支持多种LLM(大语言模型)，实现智能对话
视觉感知	支持多种VLLM(视觉大模型)，实现多模态交互
意图识别	支持外挂的大模型意图识别、大模型自主函数调用，提供插件化意图处理机制
记忆系统	支持本地短期记忆、mem0ai接口记忆、PowerMem智能记忆，具备记忆总结功能
知识库	支持RAGFlow知识库，让大模型判断需要调度知识库后再回答
工具调用	支持客户端IOT协议、客户MCP协议、服务端MCP协议、MCP接入点协议、自定义工具函数
指令下发	依托MQTT协议，支持从智控台将MCP指令下发到ESP32设备
管理后台	提供Web管理界面，支持用户管理、系统配置和设备管理；界面支持中文简体、中文繁体、英文显示
测试工具	提供性能测试工具、视觉模型测试工具和音频交互测试工具
部署支持	支持Docker部署和本地部署，提供完整的配置文件管理
插件系统	支持功能插件扩展、自定义插件开发和插件热加载

想了解具体开发计划进度，请点击这里。常见问题及相关教程，可参考这个链接

如果你是一名软件开发者，这里有一份《致开发者的公开信》，欢迎加入！

小智是一个生态，当你使用这个产品时，也可以看看其他在这个生态圈的优秀项目

本项目支持的平台/组件列表 📋

使用方式	支持平台	免费平台
openai 接口调用	阿里百炼、火山引擎、DeepSeek、智谱、Gemini、科大讯飞	智谱、Gemini
ollama 接口调用	Ollama	-
dify 接口调用	Dify	-
fastgpt 接口调用	Fastgpt	-
coze 接口调用	Coze	-
xinference 接口调用	Xinference	-
homeassistant 接口调用	HomeAssistant	-

实际上，任何支持 openai 接口调用的 LLM 均可接入使用。

使用方式	支持平台	免费平台
openai 接口调用	阿里百炼、智谱ChatGLMVLLM	智谱ChatGLMVLLM

实际上，任何支持 openai 接口调用的 VLLM 均可接入使用。

使用方式	支持平台	免费平台
接口调用	EdgeTTS、科大讯飞、火山引擎、腾讯云、阿里云及百炼、CosyVoiceSiliconflow、TTS302AI、CozeCnTTS、GizwitsTTS、ACGNTTS、OpenAITTS、灵犀流式TTS、MinimaxTTS	灵犀流式TTS、EdgeTTS、CosyVoiceSiliconflow(部分)
本地服务	FishSpeech、GPT_SOVITS_V2、GPT_SOVITS_V3、Index-TTS、PaddleSpeech	Index-TTS、PaddleSpeech、FishSpeech、GPT_SOVITS_V2、GPT_SOVITS_V3

VAD 语音活动检测

类型	平台名称	使用方式	收费模式	备注
VAD	SileroVAD	本地使用	免费

使用方式	支持平台	免费平台
本地使用	FunASR、SherpaASR	FunASR、SherpaASR
接口调用	FunASRServer、火山引擎、科大讯飞、腾讯云、阿里云、百度云、OpenAI ASR	FunASRServer

Voiceprint 声纹识别

使用方式	支持平台	免费平台
本地使用	3D-Speaker	3D-Speaker

类型	平台名称	使用方式	收费模式	备注
Memory	mem0ai	接口调用	1000次/月额度
Memory	powermem	本地总结	取决于LLM和DB	OceanBase开源，支持智能检索
Memory	mem_local_short	本地总结	免费
Memory	nomem	无记忆模式	免费

类型	平台名称	使用方式	收费模式	备注
Intent	intent_llm	接口调用	根据LLM收费	通过大模型识别意图，通用性强
Intent	function_call	接口调用	根据LLM收费	通过大模型函数调用完成意图，速度快，效果好
Intent	nointent	无意图模式	免费	不进行意图识别，直接返回对话结果

Rag 检索增强生成

类型	平台名称	使用方式	收费模式	备注
Rag	ragflow	接口调用	根据切片、分词消耗的token收费	借助RagFlow的检索增强生成功能，提供更准确的对话回复

Logo	项目/公司	说明
	百聆语音对话机器人	本项目受百聆语音对话机器人启发，并在其基础上实现
	十方融海	感谢十方融海为小智生态制定了标准的通讯协议、多设备兼容性方案及高并发场景实践示范；为本项目提供了全链路技术文档支持
	玄凤科技	感谢玄凤科技贡献函数调用框架、MCP通信协议及插件化调用机制的实现代码，通过标准化的指令调度体系与动态扩展能力，显著提升了前端设备(IoT)的交互效率和功能延展性
	huangjunsen	感谢huangjunsen 贡献`智控台移动端`模块，实现了跨平台移动设备的高效控制与实时交互，大幅提升了系统在移动场景下的操作便捷性和管理效率
	汇远设计	感谢汇远设计为本项目提供专业视觉解决方案，用其服务超千家企业的设计实战经验，赋能本项目产品用户体验
	西安勤人信息科技	感谢西安勤人信息科技深化本项目视觉体系，确保整体设计风格在多场景应用中的一致性和扩展性
	代码贡献者	感谢所有代码贡献者贡献者，你们的付出让项目更加健壮和强大。