AgentIndex icon
AgentIndex
ToolsMCP ServersHOTCategoriesTrendingNewBest ListsCompareGuides
Submit Tool
ToolsMCP ServersHOTCategoriesTrendingNewBest ListsCompareGuides
Home/
Voice / Speech/
xiaozhi-esp32-server
xiaozhi-esp32-server logo

xiaozhi-esp32-server

Active·★ 11.1k·MIT·Updated 2026-10-27
★ Most Popular★ Essential★ Trending

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.

This write-up is based on the project's README and public repository data. We have not hand-tested the tool. Data as of 2026-10-24.

License
MIT
Latest release
v0.9.8 · 2026-10-23
Last commit
2026-10-24
Contributors
152
Forks
3,744
Open issues and PRs
736
First published
2025-02-02

Source: GitHub, npm and PyPI public APIs.

#ESP32#Backend#AI#IoT#Voice Assistant
$ Install
$ git clone https://github.com/xinnan-tech/xiaozhi-esp32-server.git
↗ Visit site★ GitHub
01

Features

01Core architecture with MQTT+UDP, WebSocket, HTTP server, console management, and authentication.
02Advanced voice interaction supporting streaming ASR/TTS, VAD, and multi-language processing.
03Real-time voiceprint recognition for personalized responses in multi-user environments.
04Intelligent dialogue capabilities powered by various large language models (LLMs).
05Multimodal visual perception through integration with vision large language models (VLLMs).
02

Why choose it

+Lets you run your own backend for xiaozhi-esp32 devices instead of depending on a shared service.
+Supports MQTT+UDP, WebSocket, MCP endpoints, voiceprint recognition and a knowledge base.
+Two deployment modes: a minimal no-database install and a full install with a web console and multi-user management.
+Wide choice of LLM, ASR, TTS, VAD, memory and RAG components, and MIT licensed.
03

Trade-offs

!It requires ESP32 hardware; the project is not useful without a compatible device.
!The README states the project is incomplete, has not passed a network security evaluation and should not be used in production.
!The README and docs are mainly in Chinese, and third-party speech and LLM providers are your own responsibility.
05

Maintenance check

ActiveChecked: 2026-10-25
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
Commits per week, last 12 weeks
Commits per week, last 12 weeks: 7, 6, 1, 26, 6, 5, 1, 1, 7, 24, 15, 0

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.

04

Who it fits

Pick it if
  • 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.
Look elsewhere if
  • 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.
06

How it differs

xiaozhi-esp32-server-java logovs xiaozhi-esp32-server-java★ 1.4k

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.

Full comparison →
07

Compatibility

智谱
Supported (Free)
Verified via docs
Ollama
Supported
Verified via docs
智谱ChatGLMVLLM
Supported (Free)
Verified via docs
灵犀流式TTS
Supported (Free)
Verified via docs
火山引擎
Supported
Verified via docs
FunASR
Native (Local/Free)
Verified via docs
08

Quick start

1
$ git clone https://github.com/xinnan-tech/xiaozhi-esp32-server.git
09

Use cases

↳Establishing a private backend service for `xiaozhi-esp32` smart hardware.
↳Integrating smart voice control for home automation and appliance management.
↳Developing advanced intelligent assistants for specialized applications like healthcare.
10

Alternatives

⚡Top VS:
VSxiaozhi-esp32-server-java★1.4k→VSMCP-Nest★724→VShacker-podcast★2.6k→VSjarvis★2.1k→
xiaozhi-esp32-server-java logo
xiaozhi-esp32-server-java★ 1.4k
小智ESP32的Java企业级管理平台,提供设备监控、音色定制、角色切换和对话记录管理的前后端及服务端一体化解决方案
VSCompare→
MCP-Nest logo
MCP-Nest★ 724
A NestJS module to effortlessly create Model Context Protocol (MCP) servers for exposing AI tools, resources, and prompts.
VSCompare→
hacker-podcast logo
hacker-podcast★ 2.6k
一个基于 AI 的 Hacker News 中文播客项目,每天自动抓取 Hacker News 热门文章,通过 AI 生成中文总结并转换为播客内容。
VSCompare→
jarvis logo
jarvis★ 2.1k
Private local AI assistant for your desktop. Voice and text chat, personal memory, dictation and MCP tools. Runs offline with Ollama or OpenAI-compatible servers on macOS, Windows and Linux.
VSCompare→
jarvis-assistant-vocal logo
jarvis-assistant-vocal★ 521
Assistant vocal local en francais : Claude ou Ollama (offline), domotique Hue, OBS, agenda, navigateur, appels Twilio, serveur MCP. Python.
VSCompare→
vexa logo
vexa★ 2.9k
Open-source meeting transcription API for Google Meet, Microsoft Teams & Zoom. Auto-join bots, real-time WebSocket transcripts, MCP server for AI agents. Self-host or use hosted SaaS.
VSCompare→
langchain4j-aideepin logo
langchain4j-aideepin★ 1.4k
基于AI的工作效率提升工具(聊天、绘画、知识库、工作流、 MCP服务市场、语音输入输出、长期记忆) | Ai-based productivity tools (Chat,Draw,RAG,Workflow,MCP marketplace, ASR,TTS, Long-term memory etc)
VSCompare→
agenticmail logo
agenticmail★ 242
Email & SMS infrastructure for AI agents — send and receive real email and text messages programmatically
VSCompare→
See all alternatives →

Featured in these lists

  • Best Open-Source Voice Assistants and Speech Tools

Comments

Log in to leave a comment

No comments yet. Be the first!

On this page
01Features02Why choose it03Trade-offs05Maintenance check04Who it fits06How it differs07Compatibility08Quick start09Use cases10Alternatives
xinnan-tech /
xiaozhi-esp32-server
↗

Self-hosted backend for xiaozhi-esp32 voice hardware with MCP and knowledge base

11.1k3.7kMIT
Last commit1d ago
StatusActive
CategoryVoice / Speech
Contributors152
Latest releasev0.9.8
Links
Documentation↗Discussion↗Issues↗Releases↗
Cloud Infrastructure
Ad

Deploy on DigitalOcean

Host your MCP servers, Docker containers, and AI agents with $200 free credit over 60 days.

Claim $200 Free Credit
© 2026 AgentIndex.app|Built by a 10-year iOS Developer.
Best by use caseAboutContactAdvertisePrivacy PolicyTerms of UseQYSGitHubBuy me a coffee ☕

Browse by Category

MCP ServersCode AssistantWorkflow AutomationRAG / Knowledge BaseMulti-AgentBrowser AutomationLLM InfraDev ToolingObservability

Not affiliated with Anthropic, OpenAI or Microsoft.