33rd of 62 in VoiceFor voice, speech and music

xiaozhi-esp32

ESP32 firmware for a voice chatbot with MCP device and cloud tool control

Stars
31.9k
License
MIT
Last commit
Oct 2026
Last release
Oct 2026
Language
C++
Stars, last 29 weeks+6,840
3 Apr 2026: 25,011 stars10 Apr 2026: 25,216 stars17 Apr 2026: 25,419 stars24 Apr 2026: 25,643 stars1 May 2026: 25,791 stars8 May 2026: 25,977 stars15 May 2026: 26,197 stars22 May 2026: 26,414 stars29 May 2026: 26,618 stars5 Jun 2026: 26,819 stars12 Jun 2026: 27,064 stars19 Jun 2026: 27,239 stars26 Jun 2026: 27,436 stars3 Jul 2026: 27,646 stars10 Jul 2026: 27,828 stars17 Jul 2026: 28,011 stars24 Jul 2026: 28,179 stars31 Jul 2026: 28,367 stars7 Aug 2026: 28,601 stars14 Aug 2026: 28,799 stars21 Aug 2026: 28,975 stars28 Aug 2026: 29,326 stars4 Sept 2026: 29,548 stars11 Sept 2026: 29,772 stars18 Sept 2026: 29,999 stars25 Sept 2026: 30,180 stars2 Oct 2026: 30,352 stars9 Oct 2026: 30,563 stars16 Oct 2026: 31,313 stars23 Oct 2026: 31,851 stars

25,011 on 3 Apr 202631,851 on 23 Oct 2026

From GitHub's daily star counts.

Checked on GitHub.

Overview

C++ firmware that turns ESP32 boards into a voice chatbot. It does offline wake-word detection with ESP-SR and streams Opus audio over WebSocket or MQTT+UDP to a server that handles ASR, LLM and TTS. MCP is used on the device (speaker, LED, servo, GPIO) and in the cloud (smart home, email, search). It connects to the hosted xiaozhi.me server by default, and self-hosted server projects are listed.

Who it is for: Hardware hobbyists and embedded engineers building ESP32 voice assistants

Ranked among open-source alternatives to ElevenLabs (#3 of 10) and Otter.ai (#4 of 10).

Strengths

  • Supports 138 board directories and 171 release variants across ESP32, C3, C5, C6, S3 and P4
  • Documented WebSocket and MQTT+UDP protocols let third-party servers and clients interoperate
  • Offline wake-word detection with customizable wake words; Wi-Fi, Ethernet and Cat.1 4G networking
  • Prebuilt firmware can be flashed without setting up a development environment

Weaknesses

  • Models do not run on the device; a server is needed for ASR, LLM and TTS
  • Default setup depends on the hosted xiaozhi.me service and an account
  • Requires ESP-IDF 6.0.1 or later; 5.x is unsupported and the v6.1 tag has a reported C3 Wi-Fi bug
  • Beginner tutorials are on Feishu and bilibili, mostly in Chinese

What it needs

  • no GPU
  • Docker
  • Needs ESP-IDF 6.0.1+, ESP32 board, xiaozhi.me or compatible server
  • Models: Qwen, DeepSeek, Realtime end-to-end voice models

Quick answers

Is xiaozhi-esp32 open source?

Yes. Its code is on GitHub under the MIT license.

Can you run xiaozhi-esp32 with Docker?

Yes. Its repository has a Docker setup: a Dockerfile, a Compose file or a published image.

Does xiaozhi-esp32 need a GPU?

No, it runs without one.

Head to head

Also in Voice

See all 62
Also in Voice
RankProjectScore
1voicestudioDesktop app for voice cloning, dubbing, dictation and audiobooks83.9k starsAGPL-3.096 out of 100
2whisper.cppC/C++ port of OpenAI Whisper for local speech-to-text transcription54.6k starsMIT89 out of 100
#4buzzOffline desktop app for transcribing and translating audio with Whisper22.2k starsMIT80 out of 100
#5agentsPython framework for realtime voice and multimodal agents on LiveKit WebRTC Live demo ↗ (opens in a new tab)14.9k starsApache-2.079 out of 100
#6meetilyDesktop app that records, transcribes and summarizes meetings locally Live demo ↗ (opens in a new tab)32.1k starsMIT78 out of 100