EchoMuse README

The project's README from github.com/wilbowes/EchoMuse. As one markdown file: README.md.

EchoMuse

Turn an old Amazon Echo Dot (2nd gen) into a local voice assistant for Home Assistant.

CI Firmware emOS Controller License: MIT

Join the community — Discord · r/echomuse

EchoMuse makes a second-hand Echo Dot a voice satellite for Home Assistant: say the wake word, ask something, and hear the answer from the Dot. There is no Amazon account, no Alexa and no cloud service of ours. The Dot shows up in Home Assistant as an ordinary ESPHome voice satellite, so there is nothing extra to install there.

At a glance

What it is

What it isn't

What you need
An Echo Dot 2nd gen The hardware being repurposed.
Home Assistant With a working Assist pipeline.
An always-on computer Runs the controller. The Home Assistant machine itself is fine if it runs add-ons.
A Linux computer (a live USB works) and a micro-USB cable, once To unlock the Dot. The unlock does not run on macOS.
Chrome or Edge, once The setup wizard talks to the Dot over USB from the browser.

Getting started

  1. Unlock the Dot with R0rt1z2's amonet-biscuit. Either version works: v1.1.0 leaves it on FireOS 5, v2.0.0 moves it to FireOS 6. The rooting guide explains the choice. You do this at your own risk.

  2. Start the controller, as an add-on:

    Add the EchoMuse repository to Home Assistant

    or with Docker:

    mkdir echomuse && cd echomuse
curl -O https://raw.githubusercontent.com/wilbowes/EchoMuse/main/controller/docker-compose.deploy.yml
curl -o .env https://raw.githubusercontent.com/wilbowes/EchoMuse/main/controller/.env.example
docker compose -f docker-compose.deploy.yml up -d

  3. Run the setup wizard from the dashboard with the Dot plugged in over USB. It installs everything and joins your WiFi. Approve the Dot in the dashboard and Home Assistant discovers it.

The quickstart walks through all three.

emOS or FireOS?

The wizard offers two ways to run EchoMuse on the Dot:

Features

Privacy

Status and known issues

EchoMuse is in active development and runs daily on a small fleet. emOS is newer than FireOS and has fewer device-hours behind it. Open issues worth knowing before you start:

Everything else is in the issue tracker.

Getting help

Documentation
Quickstart From nothing to talking to your Dot.
Rooting Unlocking the Dot, and which amonet version to use.
Configuration Every setting, in plain language.
FAQ Common problems and their fixes.
emOS How our own userspace on the Dot works.
How the voice pipeline works The path from wake word to answer.
Device ↔ controller protocol For porting EchoMuse to new hardware.
Contributing Building from source, tests, and how to send changes.
Engineering journal How each part was worked out, including the dead ends.

How it's built

EchoMuse is written largely with Claude, Anthropic's AI model, directed by the maintainer. More than half the commits carry a Co-Authored-By: Claude line, and replies on our issues are signed "Team EchoMuse (powered by Claude)". Nothing about that is hidden.

Credits

EchoMuse would not exist without:

Licence

EchoMuse is MIT licensed. It includes third-party components that keep their own licences, listed with their copyright notices in NOTICE.md. emOS releases also ship busybox (GPL-2.0), with its source and licence attached to each release, and wpa_supplicant (BSD).

Amazon, Echo, Echo Dot, Alexa and FireOS are trademarks of Amazon.com, Inc. or its affiliates. EchoMuse is an independent project, not affiliated with or endorsed by Amazon.

EchoMuse (wilbowes/EchoMuse)

Searching Database…

1.3K ·GitHub
EchoMuse
Что это такое?Превращает б/у Amazon Echo Dot (2-го поколения, 2016 года) в локальную голосовую спутницу для Home Assistant: скажите слово пробуждения, задайте вопрос — и услышите ответ из самого Dot. Без аккаунта Amazon, без Alexa, без облака — микрофоны, динамик, светодиодное кольцо и кнопки продолжают работать.
Это программа работает на моём компьютере, на самом Dot или и там и там?И там и там. Контроллер работает в вашей сети как аддон Home Assistant или Docker-контейнер, а на сам Dot устанавливается прошивка на замену — по умолчанию emOS либо рутованный FireOS.
Как выглядит настройка с нуля до работающего Dot?Три шага: один раз разблокировать Dot по USB с помощью утилиты amonet-biscuit от R0rt1z2, запустить контроллер как аддон Home Assistant или Docker-контейнер, затем пройти мастер настройки из панели управления с подключённым Dot — он установит всё необходимое и подключит устройство к вашей Wi-Fi сети.
Нужно ли что-то ещё, кроме самого Dot?Home Assistant с настроенным Assist pipeline и постоянно включённый компьютер для контроллера. Для разовой разблокировки также нужен компьютер с Linux (подойдёт live USB), кабель micro-USB и Chrome или Edge — на macOS разблокировка не работает.
Что может пойти не так, и есть ли риск для Dot?Из коробки это ещё не готово: при ошибке на одном из шагов разблокировка может превратить Dot в «кирпич» (в теме на XDA описано восстановление). Пока работает только Dot 2-го поколения — порты для Dot 3, Echo 2 и Echo Show 8 в разработке — а emOS на FireOS 6 не умеет подключаться к сетям WPA3.
Уходит ли что-то из сказанного мной за пределы моей сети?Ваша речь остаётся в локальной сети: Dot сам слушает слово пробуждения, затем звук передаётся на контроллер и дальше в Home Assistant — без телеметрии и аналитики. Если Assist pipeline полностью локальный (Whisper и Piper), за пределы сети не уходит ничего.
Лицензия — это чистый MIT или есть нюансы в мелком шрифте?Для самого EchoMuse — MIT, но сторонние компоненты сохраняют свои лицензии (см. NOTICE.md), а в релизах emOS входят busybox (GPL-2.0) и wpasupplicant (BSD) с приложенными исходниками.
Что вообще умеет оживший Dot?Голосовое управление через Assist в Home Assistant, слово пробуждения на самом Dot или на контроллере, перебивание (barge-in) и дома с несколькими Dot, где отвечает тот, кто первым услышал слово пробуждения. Каждый Dot также работает как медиаплеер Home Assistant (браузер медиатеки, Music Assistant, радио), плюс таймеры, объявления, Bluetooth-прокси на каждом Dot и датчик освещённости.
emOS или рутованный FireOS — что выбрать?По умолчанию — emOS: он заменяет Android от Amazon на компактное Linux-окружение, работает на устройствах с FireOS 5 и 6, и на нём нормально работает разъём 3.5 мм; мастер настройки сохраняет исходный образ загрузки, а восстановление занимает около десяти секунд. Рутованный FireOS оставляет Android 5, работает только на FireOS 5 — это более старый, проверенный временем путь.
Могу ли я обучить своё слово пробуждения?Да — слова пробуждения обучаются с помощью owwforge и устанавливаются из панели управления. Распознавание может работать на каждом Dot или на контроллере, и если Dot не справляется, контроллер автоматически берёт это на себя, так что устройство никогда не «оглохнет».
Кнопка отключения микрофона на Dot действительно отключает микрофоны?Не на аппаратном уровне. Это программное отключение: микрофоны глушатся в аудиочипе, и EchoMuse отказывается слушать, пока кнопка включена, но у Dot 2 нет аппаратного переключателя, который физически их отсоединяет.
What are similar projects?techo5, local_roborock_server, espectre, Tasmota, V3SP3R, esphome, xiaozhi-esp32, lipflow
Which topics is it in?smart-home, root, home-assistant, media-player, home-automation, bluetooth, music-player, voice-assistant, homelab, audio-processing, local-ai, whisper
Creator
wilbowes
Size
8.7 MB
Stars
1.3K
Updated
CommitOct 16Releasev2.18.1Oct 15
Age
5mo
Commits · 90 Days