AtomS3R + Atomic Echo Base Voice Assistant

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

Preparation

• Refer to the Home Assistant Official Documentation to install Home Assistant version 2025.12.3 or higher.
• Refer to the following tutorials to complete the installation and configuration of voice recognition related add-ons.
  • Home Assistant Cloud.
  • Assist Pipeline.
• Install the ESPHome add-on in Setting -> Add-ons -> Add-ons STORE.
• After the ESPHome add-on is successfully installed, toggle on Show in sidebar on the ESPHome management page to add it to the left navigation bar.

Note

• 2026-02: Resolved compilation errors caused by changes in the new version of the ESPHome API. The new version is compiled under ESPHome 2025.1.2. If you encounter problems, consider switching to this version.

Create Device

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

2. Click CONTINUE in the pop-up window.

3. Select New Device Setup to create a new configuration file.

4. Fill in the configuration file name.

5. Select the device type; simply click ESP32-S3.

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

Modify Configuration

1. Click EDIT on the newly generated configuration to modify it. (The Wi-Fi configuration defaults to the current HA server's Wi-Fi configuration, but you can also configure options like ssid and password according to your actual situation).

2. Add the following resource package configuration link to add the voice assistant functional components to the device.

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

3. Click SAVE and INSTALL in the upper right corner. In the installation method pop-up, select Manual download.

Download and Flash Firmware

1. After the firmware compilation is complete, click the Download button and select the Factory Format (Previously Modern) format firmware to download locally.

2. Click Open ESPHome Web to use the web flashing tool for flashing.

3. Assemble the AtomS3R and Atomic Echo Base. Connect the AtomS3R device to your computer via a USB-C cable. Long-press the reset button until the green light turns on and then release it to enter download mode.

4. In Open ESPHome Web, click CONNECT to connect the device and select the corresponding device port.

5. Click INSTALL.

6. Select the *.bin file compiled in the previous step and click the INSTALL button again to begin flashing.

Wait for the flashing process to complete.

Learn

1. After flashing the firmware, the device will automatically connect to Wi-Fi upon startup. The Home Assistant service on the same local area network will notify you that a new device has been discovered. In Notifications, select the new device and click Check it out -> CONFIGURE. Follow the pop-up steps to add the device to the specified area to complete the configuration. If you do not receive a new device notification, click Settings -> Device & services to view the device status.

2. Next, you can continue to set up the Voice Assistant, or skip this step and set it up later.

   • Test the wake word.
     

   • Select the area.
     

   • Select the Pipeline.
     

   • Complete the setup.
     

Once the device is added and the Home Assistant Cloud and Assist pipeline add-ons are configured in the preparation steps, you can use the wake word "Okay Nabu" to wake up the voice assistant.

Demo video:

Video