Acoustic event detection mesh for Home Assistant, built by AxeForging.
"Dumb edge, smart server" acoustic event detection. Cheap ESP32 units (M5Stack ATOM Echo today, more boards welcome) stream raw audio to a server that runs it through YAMNet + openWakeWord and publishes detections to Home Assistant over MQTT — baby crying, a smoke alarm going off, glass breaking, a dog barking, someone at the door, shouting, screaming, and a couple of provisional wake-word slots for shouting for help. The smoke-alarm detector also runs entirely on-device, so it still works if the server or your network goes down.
- Baby cry, smoke alarm (dual-path: on-device + server, survives an outage), glass break, dog bark, doorbell, shout, scream — all via YAMNet audio classification, no network round-trip needed for the smoke alarm.
- Wake-word slots for "help" (English) and "socorro" (Portuguese) — the
pipeline is wired end-to-end, real trained models are the next step (see
docs/wake-word-training.md). - MQTT Discovery — entities show up in Home Assistant automatically, no manual YAML.
- Privacy-first — no audio persisted anywhere outside an explicit opt-in debug mode. Raw PCM never leaves the LAN.
- Any number of units — not capped at a fixed fleet size.
- In Home Assistant: Settings → Add-ons → Add-on Store → ⋮ → Repositories
→ add
https://github.com/AxeForging/heyra. - Install the Heyra Add-on — the detection service, plus a live view of your configured units in its Ingress panel.
- Flash each ATOM Echo from axeforging.github.io/heyra/flash.html — runs entirely in your browser (Chrome/Edge, via WebSerial), no dev machine or CLI needed.
- See
homeassistant/README.mdfor the full setup checklist (MQTT, notifications, automations).
| Board | Status |
|---|---|
| M5Stack ATOM Echo | Verified, in production use |
Built to add more — see firmware/boards/README.md
for the hardware contract a new board profile needs to satisfy.
firmware/ ESPHome firmware + the udp_audio_streamer component (Goertzel/T3 smoke detection)
addons/ Home Assistant Add-on (heyra -- the detection service)
homeassistant/ Automations, dashboard, MQTT reference config
server/ Plain docker-compose deployment, for non-HA users
docs/ Build plan, wake-word training runbook
web/ Project landing page
Full architecture and status: CLAUDE.md.
Built by the AxeForging team. Check out our other tools at tools.axeforge.io.