78/xiaozhi-esp32

▲ 2,146 stars today★ 32,982⑂ 7,799

An MCP-based chatbot | 一个基于MCP的聊天机器人

About 78/xiaozhi-esp32

78/xiaozhi-esp32 is an open-source project on GitHub, mainly written in C++. An MCP-based chatbot | 一个基于MCP的聊天机器人 It currently holds 32,982 stars and 7,799 forks with 698 open issues, and was last pushed on 2026-11-07 (repository created 2024-08-31).

Project Overview

Git Homed tracks it on the Today's Trending board.

GitHub Repository Details

Repository 78/xiaozhi-esp32 · default branch main · size 12125 KB · watchers 257 · source: GitHub REST API and repository README

README

An MCP-based Chatbot

(English | 中文 | 日本語)

Introduction

📖 XiaoZhi AI Guides & Help

👉 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.

https://github.com/78/xiaozhi-esp32/blob/HEAD/Control everything via MCP

Recent Updates

Features Implemented

Hardware

Breadboard DIY Practice

Follow the step-by-step breadboard tutorial:

👉 ESP32-S3 Breadboard Tutorial

Breadboard demo:

Breadboard Demo

Supports 138 Board Directories and 171 Release Variants (Partial List)

Software

Firmware Flashing

For beginners, it is recommended to use the firmware that can be flashed without setting up a development environment.

The firmware connects to the official xiaozhi.me server by default. Personal users can register an account to use the Qwen real-time model for free.

👉 Beginner's Firmware Flashing Guide

Development Environment

Use the release/v6.1 branch rather than the v6.1 release tag: an ESP32-C3 Wi-Fi initialization failure with that tag is reported in #2344. After switching SDK revisions, run git submodule update --init --recursive in the ESP-IDF directory, source its export.sh, and run idf.py fullclean in this project before rebuilding.

Developer Documentation

Large Model Configuration

If you already have a XiaoZhi AI chatbot device and have connected to the official server, you can log in to the xiaozhi.me console for configuration.

👉 Backend Operation Video Tutorial (Old Interface)

Related Open Source Projects

For server deployment on personal computers, refer to the following open-source projects:

Other client projects using the XiaoZhi communication protocol: Custom Assets Tools:

About the Project

This is an open-source ESP32 project, released under the MIT license, allowing anyone to use it for free, including for commercial purposes.

We hope this project helps everyone understand AI hardware development and apply rapidly evolving large language models to real hardware devices.

If you have any ideas or suggestions, please feel free to raise Issues or join our Discord or QQ group: 1095994019

Star History

https://github.com/78/xiaozhi-esp32/blob/HEAD/Star History Chart

GitHub Stars & Activity

32,982Stars
7,799Forks
698Open issues
C++Language

GitHub Popularity

GitHub stars32,982
Forks7,799
Open issues698
Primary languageC++
LicenseMIT
Stars gained today2,146
Created2024-08-31
Last pushed2026-11-07

Trending History

Monthly boardrank #90 · ▲ 2,146 stars

Related GitHub Projects

1

boykopovar / AnyPS5

C++★ 54,660⑂ 5,242▲ 317 stars
→
2

deskflow / deskflow

C++★ 31,285⑂ 5,153▲ 83 stars
→
3

clice-io / clice

C++★ 1,749⑂ 101▲ 118 stars
→
4

Helldez / BigMoeOnEdge

C++★ 992⑂ 102▲ 98 stars
→
5

mattpocock / skills

Shell★ 326,317⑂ 27,407▲ 793 stars
→
6

obra / superpowers

Shell★ 318,900⑂ 28,421▲ 1,905 stars
→
7

affaan-m / ECC

JavaScript★ 304,931⑂ 44,904▲ 718 stars
→
8

ossu / computer-science

HTML★ 211,199⑂ 26,151▲ 66 stars
→

More Trending Repositories