xiaozhi-esp32-server
xiaozhi-esp32-server is the backend service for the open-source xiaozhi-esp32 smart hardware project, implemented in Python, Java and Vue according to the Xiaozhi communication protocol. It was led by a team at South China University of Technology. It supports MQTT with UDP and WebSocket protocols, MCP endpoints, voiceprint recognition and a knowledge base, and is meant for people who already own ESP32 hardware and want to host their own backend instead of using a shared one.
Two deployment modes are offered: a minimal install for low-spec environments with a single agent and settings kept in config files (no database), and a full-module install with multi-user and multi-agent management, a web control console and database storage, each available as Docker or from source. The component list covers many LLM, vision, text-to-speech, voice-activity-detection, speech recognition, voiceprint, memory, intent and RAG options. The README is clear that the project is incomplete, has not passed a network security evaluation and should not be used in production, and that it has no commercial relationship with, and gives no guarantee about, any third-party API provider.
Features
Why choose it
Trade-offs
Maintenance check
- Last commit
- 2026-10-23
- Commits, last 90 days
- 100+
- Releases, last 90 days
- 2
- Latest release
- v0.9.8 (2026-10-23)
- Open issues
- 737
- Recent issues with at least one comment
- 12/19
Oldest week on the left; the latest four weeks are orange. Source: GitHub commit activity.
Status rule: archived on GitHub = Archived; last commit within 90 days = Active; 91 to 365 days = Slowing; older = Stale. All figures come from the GitHub API on the date shown.
Most discussed open issues
- #2270 [Bug] mqtt部署后,连接显示都是成功的,但是我说话他接收不到音频,我用文字发送,他有收不到音频21 comments · 2025-09-22
- #2613 OTA 升级有同步xiaozhi-esp32 v2更新嘛?18 comments · 2025-11-27
- #1192 [Bug] 查询天气获取城市的问题17 comments · 2025-05-11
- #1676 如何开启智能体的记忆模式16 comments · 2025-06-26
- #1448 [Bug] 立创实战派S3调用视觉后台报错15 comments · 2025-06-02
Issue titles are quoted from GitHub. Open the link to check whether a problem still applies to the version you use.
Who it fits
- You own xiaozhi-esp32 hardware and want to host your own backend instead of a shared one.
- You want MQTT+UDP or WebSocket, MCP endpoints, voiceprint recognition and a knowledge base.
- You want a choice between a minimal no-database install and a full install with a web console and multi-user management.
- You have no ESP32 device: it is not useful without compatible hardware.
- You need production use: the README says it is incomplete and has not passed a network security evaluation.
- You cannot work from mainly Chinese documentation.
How it differs
The Java server is a separate implementation with an admin console, needing MySQL 8, Redis 7 and about 1.8 GB of memory. xiaozhi-esp32-server also offers a minimal install with no database.
Compatibility
Quick start
Use cases
Alternatives
Featured in these lists
Comments
No comments yet. Be the first!