RealDeco/xiaozhi-esphome

Alternative code to use xiaozhi ai devices in esphome/home assistant.

What it solves

It allows users to repurpose Xiaozhi-based hardware devices as voice assistant satellites for Home Assistant, providing a way to integrate these compact devices into a smart home ecosystem via ESPHome.

How it works

Users flash the device with specific ESPHome configurations (YAML files) provided in the repository. Once the device is configured and connected to Wi-Fi, it is added to Home Assistant, which then manages the voice assistant setup process.

Who it’s for

Home automation enthusiasts who own Xiaozhi-based hardware (such as EchoEar, Spotpear, or Waveshare devices) and want to use them as voice-controlled interfaces for Home Assistant.

Highlights

  • Supports a wide variety of hardware including EchoEar, Spotpear Ball/Muma, Waveshare displays, and DIY breadboard setups.
  • Integrates directly with ESPHome for wireless updates and configuration.
  • Provides dedicated configuration files for different device versions and modular updates.

Related

  • Project
    xinnan-tech/xiaozhi-esp32-server

    A backend server for the xiaozhi-esp32 project that enables ESP32 devices to become AI assistants with voice, vision, and smart home control capabilities.

  • Project
    esphome/home-assistant-voice-pe

    The ESPHome source code for the Home Assistant Voice: Preview Edition, providing the firmware needed for voice-controlled home automation hardware.

  • Project
    78/xiaozhi-esp32

    An open-source ESP32-based AI voice chatbot framework that integrates LLMs and the Model Context Protocol (MCP) for real-time voice interaction and hardware control.

  • Project
    jxlarrea/voice-satellite-card-integration

    A Home Assistant integration that turns any browser or tablet into a private voice assistant satellite with on-device wake word detection and visual feedback.

  • Project
    OHF-Voice/linux-voice-assistant

    Linux-Voice-Assistant is an open-source tool that turns a Linux device into a voice satellite for Home Assistant. It handles wake word detection locally and streams your speech to Home Assistant's Assist, letting you build your own smart speaker with timers, announcements, and conversation support.