AtomS3R + Atomic Echo Base Voice Assistant

This guide shows how to combine AtomS3R with Atomic Echo Base to integrate voice assistant functionality into Home Assistant.

1. Environment Setup

• 1. Refer to the Home Assistant official documentation to install Home Assistant (version 2025.12.3 or later).
• 2. Follow the guides below to install and configure voice recognition-related add-ons:
  • Home Assistant Cloud
  • Assist Pipeline
• 3. In Settings -> Add-ons -> Add-on STORE, install the ESPHome add-on.
• 4. After ESPHome is installed, enable Show in sidebar in the ESPHome management page to add it to the left navigation.

2. Add a Device

Open the ESPHome add-on page and click NEW DEVICE at the bottom-right to create a new device.

In the popup click CONTINUE.

Choose New Device Setup to create a new configuration file.

Enter a name for the configuration file.

Select the device type and choose ESP32-S3.

Copy the Home Assistant API Encryption Key for later and click Skip.

3. Configure the Device

Click EDIT on the newly created configuration and modify settings. (Wi‑Fi settings default to the current HA server; you may override ssid, password, etc., as needed.)

Add the following package reference to include voice assistant components for the device:

packages:
    m5stack.atoms3r-with-echo-base: github://m5stack/esphome-yaml/common/atoms3r-with-echo-base.yaml@main

Then click SAVE, INSTALL, and in the install options choose Manual download.

4. Flash the Firmware

Save the firmware

• 1. After compilation finishes, click Download and choose Factory Format (Previously Modern) to save the firmware locally.
• 2. Click Open ESPHome Web to use the web flasher.

Connect and flash

Assemble AtomS3R with Atomic Echo Base. Connect AtomS3R to your computer via USB‑C, hold the reset button until the green LED lights, then release to enter download mode.

In Open ESPHome Web click CONNECT and select the device port.

Click INSTALL.

Select the previously compiled *.bin file and click INSTALL again to flash.

Wait for flashing to complete.

5. Verify the New Device

After flashing, the device will boot and automatically connect to Wi‑Fi. Home Assistant on the same LAN should discover the new device. In Notifications, select the new device and click Check it out -> CONFIGURE, then follow the prompts to add the device to a zone. If no notification appears, go to Settings -> Device & services to view the device.

You can then continue to set up the Voice Assistant or skip this step and configure it later.

• Test the wake word

• Choose the area

• Select the Pipeline

• Complete the setup

6. Wake the Device

After adding the device and configuring the Home Assistant Cloud and Assist Pipeline add-ons (see the links in the preparation steps), you can wake the voice assistant using the wake phrase "Okay Nabu".

Demo video: