XiaoZhi ESP32

活跃
GitHub C++ MIT

简介

基于 MCP 的开源 ESP32 聊天机器人，可在 ESP32 等嵌入式设备上运行 AI 对话功能，支持语音交互、多模型接入和物联网控制，适合构建智能硬件 Agent。

核心特性

  • MCP 协议设备控制 — 通过设备侧 MCP 控制扬声器、LED、舵机、GPIO 等硬件，云端 MCP 扩展智能家居和邮件等能力
  • 离线语音唤醒与识别 — 基于 ESP-SR 的离线唤醒词检测，支持 OPUS 音频编解码，流式 ASR + LLM + TTS 架构
  • 70+ 开源硬件兼容 — 支持 ESP32-C3/S3/P4 平台，兼容 LiChuang、ESP-BOX3、M5Stack、LILYGO 等 70+ 开发板
  • 多语言与多模型支持 — 支持中英日三语，接入 Qwen/DeepSeek 等大模型，支持 Websocket 和 MQTT+UDP 双协议
  • 说话人识别 — 基于 3D Speaker 模型识别当前说话人，实现个性化对话
  • 在线自定义资源 — 通过 Web 编辑器自定义唤醒词、字体、表情和聊天背景

适用场景

💡 智能家居语音控制 — 通过 ESP32 设备语音交互控制智能灯光、空调等 IoT 设备
💡 AI 桌面助手 — 在嵌入式设备上运行 LLM 对话，实现本地化的 AI 问答助手
💡 教育与创客项目 — 面包板 DIY 搭建 AI 聊天机器人，学习嵌入式 AI 开发
💡 可穿戴设备开发 — 利用 CuiCan AI Pendant 等硬件构建 AI 可穿戴设备
💡 机器人交互控制 — 通过 MCP 协议控制机械臂、机器人狗等硬件

标签

chatbot voice mcp agent api

分类

💬 聊天界面

快速开始

# 1. 克隆项目
git clone https://github.com/78/xiaozhi-esp32.git
cd xiaozhi-esp32

# 2. 安装 ESP-IDF SDK (v5.4+)
# 参考 https://docs.espressif.com/projects/esp-idf/zh_CN/latest/esp32/get-started/

# 3. 编译并烧录固件
idf.py set-target esp32s3
idf.py build
idf.py flash

# 4. 设备连接到 xiaozhi.me 服务器即可使用
访问 GitHub

相关项目