Экосистема: серверы, клиенты и порты
Прошивка устройства XiaoZhi, протокол связи и сервер — отдельные части. Пока проект реализует протокол WebSocket или MQTT + UDP, любую из частей можно заменить. Вокруг этого протокола выросла группа сторонних открытых проектов.
Список на этой странице составлен по разделу «связанные открытые проекты» в README upstream-прошивки; состояние репозитория, лицензия и описание на главной странице каждого пункта проверены (2026-10-23). Эти проекты поддерживают их авторы. Они не относятся ни к этому сайту, ни к репозиторию upstream-прошивки, а упоминание в списке не является рекомендацией: перед использованием самостоятельно оцените возможности, безопасность и лицензию.
1. Серверы
Запустите бэкенд на своём компьютере или сервере и направьте на него устройство. Шаги настройки и предупреждения по безопасности см. в разделе Собственный сервер.
| Проект | Стек | Лицензия | Кратко |
|---|---|---|---|
| xinnan-tech/xiaozhi-esp32-server | Python + Java + Vue | MIT | Поддерживает MQTT + UDP, WebSocket, конечные точки MCP, распознавание голоса по голосовому отпечатку и базу знаний, есть консоль управления |
| joey-zhou/xiaozhi-esp32-server-java | Java (Spring Boot) | MIT | Платформа управления корпоративного уровня; административный бэкенд и сервис диалога работают как два процесса |
| AnimeAIChat/xiaozhi-server-go | Go | Изменённая Apache 2.0 с дополнительными условиями | Рассчитан на личное и домашнее использование; среди дополнительных условий — запрет многопользовательского (multi-tenant) использования без письменного разрешения, поэтому перед использованием прочтите LICENSE |
| hackers365/xiaozhi-esp32-server-golang | Go | MIT | Полностью потоковая цепочка ASR → LLM → TTS, поддерживает WebSocket и MQTT + UDP |
2. Клиенты и порты
Конечные точки не на ESP32, которые «говорят» на протоколе связи XiaoZhi.
| Проект | Платформа | Лицензия | Кратко |
|---|---|---|---|
| huangjunsen0406/py-xiaozhi | Python, кроссплатформенный | MIT | Асинхронный мультимодальный фреймворк взаимодействия: голос в реальном времени, задачи компьютерного зрения, управление IoT-устройствами |
| TOM88812/xiaozhi-android-client | Flutter (Android, iOS, HarmonyOS, Web, настольные системы) | Apache-2.0 | Приложение для голосового чата в реальном времени на основе XiaoZhi, умеет подключаться к xiaozhi-server |
| 100askTeam/xiaozhi-linux | Встраиваемый Linux | В репозитории лицензия не указана | Ядро XiaoZhi для Linux без драйверов BSP для отдельных плат; список уже адаптированных плат см. в README проекта |
| 78/xiaozhi-sf32 | Bluetooth-чипы SiFli SF32 | MIT | Выход в сеть по протоколу Bluetooth PAN, кодек OPUS, MCP на стороне устройства |
| QuecPython/solution-xiaozhiAI | Модули Quectel QuecPython | В репозитории лицензия не указана | Основан на протоколе WebSocket; в примере используется плата с модулем EC800MCNLE |
3. Советы по выбору
- Сначала уточните версию протокола: каждый проект реализует протокол связи самостоятельно, поэтому поля и поведение могут не полностью совпадать с версией вашей прошивки; сверяйтесь с документами протокола.
- Сначала прочтите лицензию: у большинства проектов MIT или Apache-2.0, но у некоторых есть дополнительные условия, а у других лицензия не указана; выясните это до коммерческого использования.
- Проверьте поддержку проекта: смотрите на недавние коммиты и Issues, а не только на число звёзд.
- Помните о безопасности: сторонние серверы и клиенты работают с идентификаторами устройств и голосовыми данными; см. предупреждения по безопасности в разделе Собственный сервер.
4. Исправления и дополнения
Если в списке есть ошибка или нужно что-то добавить, напишите на [email protected], указав адрес репозитория и сведения о лицензии. О проблемах в самой прошивке сообщайте в GitHub Issues upstream.
Связанные документы
- Собственный сервер: подключение устройства к своему серверу
- Протокол связи WebSocket, гибридный протокол MQTT + UDP и протокол MCP
- Руководство по пользовательским платам
Источники: раздел «связанные открытые проекты» в README_zh.md upstream 78/xiaozhi-esp32 v2.5.2, а также README и LICENSE каждого репозитория (проверено 2026-10-23).