Back to Home
xinnan-tech icon

xiaozhi-esp32-server

Verified Safe

by xinnan-tech

Overview

Provides a robust backend service for the Xiaozhi ESP32 intelligent terminal hardware, enabling AI assistant functionalities such as voice recognition, natural language processing, knowledge base integration, voice cloning, and device control through MQTT, Websocket, and MCP protocols.

Installation

Run Command
docker-compose up -d

Environment Variables

  • VUE_APP_API_BASE_URL
  • VUE_APP_USE_CDN
  • SPRING_DATASOURCE_URL
  • SPRING_DATASOURCE_USERNAME
  • SPRING_DATASOURCE_PASSWORD
  • RENREN_REDIS_OPEN
  • OPENAI_API_KEY

Security Notes

The project demonstrates efforts in security by including XSS/SQL injection filters, JWT-based authentication, HMAC for data signing, and SM2 for password encryption. Configuration parameters, including API keys for external AI services, are externalized. However, the extensive control over connected ESP32 devices (e.g., reboot, firmware upgrade, photo capture) via MCP endpoints introduces a significant attack surface. The multi-service (Java, Python, Vue.js) and distributed nature (IoT devices, external APIs) increases complexity and potential for misconfiguration, which could be exploited. Users must ensure strict security practices for device pairing, network segmentation, and API key management.

Similar Servers

Stats

Interest Score100
Security Score7
Cost ClassMedium
Stars7798
Forks2660
Last Update2025-12-06

Tags

ESP32AI AssistantBackend ServiceIoTVoice Recognition