xiaozhi-esp32

(English | 中文 | 日本語)

👉 Human: Give AI a camera vs AI: Instantly finds out the owner hasn't washed hair for three days【bilibili】

👉 Handcraft your AI girlfriend, beginner's guide【bilibili】

As a voice interaction entry, the XiaoZhi AI chatbot leverages the AI capabilities of large models like Qwen / DeepSeek, and achieves multi-terminal control via the MCP protocol.

The current v2 version is incompatible with the v1 partition table, so it is not possible to upgrade from v1 to v2 via OTA. For partition table details, see partitions/v2/README.md.

All hardware running v1 can be upgraded to v2 by manually flashing the firmware.

The stable version of v1 is 1.9.2. You can switch to v1 by running git checkout v1. The v1 branch will be maintained until February 2026.

• Wi-Fi / ML307 Cat.1 4G
• Offline voice wake-up ESP-SR
• Supports two communication protocols (Websocket or MQTT+UDP)
• Uses OPUS audio codec
• Voice interaction based on streaming ASR + LLM + TTS architecture
• Speaker recognition, identifies the current speaker 3D Speaker
• OLED / LCD display, supports emoji display
• Battery display and power management
• Multi-language support (Chinese, English, Japanese)
• Supports ESP32-C3, ESP32-S3, ESP32-P4 chip platforms
• Device-side MCP for device control (Speaker, LED, Servo, GPIO, etc.)
• Cloud-side MCP to extend large model capabilities (smart home control, PC desktop operation, knowledge search, email, etc.)
• Customizable wake words, fonts, emojis, and chat backgrounds with online web-based editing ([Custom Assets Generator](https://g