xiaozhi-esp32-server-java

用Java轻松管理你的小智ESP32语音设备，实现音色定制与角色切换。

开源 🏷️完全免费 🔧 仅开源项目，无在线服务，需自行部署音频音乐 🍴 复刻 512 🐛 待处理 3 👀 关注 23

GitHub ↗

GitHub 星标 ★ 1417

维护状态维护中

是否开源开源

定价模式 🏷️完全免费开源项目，MIT许可证，可免费使用和部署。

项目预览

xiaozhi-esp32-server-java 项目界面预览图 — 图片来源：GitHub 官方仓库名片

项目数据

分类音频音乐

开发团队joey-zhou

GitHubhttps://github.com/joey-zhou/xiaozhi-esp32-server-java

定价模式🏷️完全免费

价格说明开源项目，MIT许可证，可免费使用和部署。

访问状态🔧 仅开源项目，无在线服务，需自行部署

是否开源是

开源协议MIT

主要语言Java

技术栈/模型esp32,java,mcp,mcp-client,mcp-server,spring-ai,stt,tts,xiaozhi,xiaozhi-ai,xiaozhi-esp32,xiaozhi-server

GitHub 星标★ 1417

上线时间2025-02-27 00:00:00

代码更新2026-09-27

仓库体积42.9 MB

本站数据更新2026-11-08

维护状态维护中

收录时间2026-08-09

浏览次数5

项目介绍

小智ESP32的Java企业级管理平台，为基于ESP32的智能语音设备提供一站式后端服务。它解决了小智AI设备在设备管理、音色定制、角色切换和对话记录管理方面的痛点，将前后端及服务端一体化。核心能力包括设备监控、灵活的TTS音色配置、多角色切换以及完整的对话日志管理。项目基于Spring AI构建，深度集成MCP（模型上下文协议）客户端与服务端，支持STT/TTS，为开发者提供了从设备接入到AI能力编排的完整闭环。通过Java技术栈，实现了企业级的高可用、可扩展架构，适合需要规模化部署和定制化管理的智能硬件场景。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

数据来源：GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 1417

技术标签

esp32 java mcp mcp-client mcp-server

使用教程

ℹ 本教程由 AI 依据该项目 README 整理，个别步骤可能需要按你的环境微调。

难度：进阶约 15 分钟部署方式：本地安装 6 步

环境要求

Linux（推荐 CentOS）或 Windows 操作系统，生产环境推荐 Linux
已安装 Git，用于克隆仓库
具备 Java 运行环境（具体版本参见 docs/CENTOS_DEVELOPMENT.md 或 docs/WINDOWS_DEVELOPMENT.md）
能正常访问 GitHub 的网络，用于下载模型与原生库
一台已烧录固件的 ESP32 智能硬件设备（用于接入验证）

安装与启动步骤

1克隆仓库

从 GitHub 拉取项目源码到本地，注意仓库较大，网络不畅时可配置代理。
```
git clone https://github.com/joey-zhou/xiaozhi-esp32-server-java
```
2进入项目目录

切换到克隆下来的项目根目录，后续脚本命令都在此目录下执行。
```
cd xiaozhi-esp32-server-java
```
3下载模型与原生库

models/ 和 lib/ 不在 Git 仓库中，首次部署必须执行本脚本下载模型和原生库。
```
./scripts/download_models.sh
```
4下载基础资源(可选)

若使用第三方 STT/TTS，可改跑该脚本，仅下载 VAD 模型和原生库，减少下载量。
```
./scripts/download_base.sh
```
5一键编译并启动

脚本会自动编译并同时启动 server 与 dialogue 两个进程，首次编译耗时较长。
```
bin/all.sh start
```
6查看运行状态

确认两个进程是否正常运行，若未启动可查看日志排查。
```
bin/all.sh status
```