A local voice satellite for your Echo and Echo Dot
Pinna is an open-source operating system for the Echo (2nd gen) and the Echo Dot (2nd gen). It detects the wake word on the device and sends your request to your own Home Assistant, or, in standalone mode, to the speech services and the language model or AI agent you choose. It doesn't use Amazon's services.
How it works
How a voice request works
1
The device hears the wake word
Pinna listens for “Alexa”, or the wake words you choose, on the device itself. Until it hears the wake word, no audio leaves the device.
2
Your assistant handles the request
With Home Assistant, the device streams your request to your Assist pipeline over the ESPHome API. In standalone mode, it sends the request to the speech-to-text, the language model or AI agent, and the text-to-speech that you set up.
3
The device answers
The reply plays on the speaker, and the light ring shows each step. Timers and music play on the device too.
Features
What Pinna does
Wake word on the device
Pinna detects the wake word with openWakeWord, on the device. It doesn't use Amazon's services.
Adds itself to Home Assistant
Home Assistant finds the device on your network, adds it like an ESPHome device, and encrypts the connection.
Works without Home Assistant
In standalone mode the device answers requests itself, with the speech services and the language model or AI agent you choose. It keeps timers, tells the weather and plays radio.
A dashboard in your browser
The device serves a web page with every setting: Wi-Fi, the wake words, who answers, your services, music sources and updates. Open it from a browser on your network.
A wake word you can tune
The dashboard lists the recent wakes and near misses, and the sensitivity that catches or ignores each one. You can also tune it at the device, with its + and − buttons.
Light ring and buttons
The ring shows what the device is doing and also works as a light. With Home Assistant, the buttons are events for your automations.
Music over AirPlay and Bluetooth
Phones and computers can play music to the device. Each source is off until you turn it on, and the wake word keeps working while music plays.
Updates that roll back
You install updates from the dashboard or from Home Assistant. An update goes to a second copy of the system, and the device returns to the old one if the new one doesn't start.
A way back to your backup
Fastboot stays reachable on every start, and one command restores the backup you made before installing.
Two modes
With Home Assistant, or on its own
You choose who answers your requests on the device's dashboard, and you can switch at any time. Everything else, from the ring to music and updates, works in both modes.
Home Assistant answers
Pinna uses the ESPHome native API. Home Assistant finds the device on your network and adds it like any ESPHome device, without YAML or an add-on. Choose an Assist pipeline for it, and say the wake word.
- Your Assist pipeline turns speech into text, acts on it and speaks the reply
- The ring, the buttons, mute, volume, timers and a media player are entities for your automations
- Home Assistant encrypts the connection itself
- New releases show in Home Assistant, and install from there
The satellite answers itself
In standalone mode the device needs no Home Assistant. You set up three services on the dashboard: speech-to-text, a brain, and text-to-speech. Use hosted services with your own keys, or servers on your own network.
- The brain is a language model, or an AI agent such as Hermes or OpenClaw
- The brain can set timers, tell the weather, play radio and light the ring
- It can use the tools of your MCP servers, and your agents can use the device over MCP
- Audio goes only to the services you chose, and only after the wake word or a press of the Action button
Home Assistant can stay connected in standalone mode. It keeps the media player, announcements, the ring and the buttons, but it no longer hears requests.
Devices
Supported devices
Pinna supports the Echo (2nd gen) and the Echo Dot (2nd gen), which share the same MT8163 platform and run the same image.
| Device | Platform | Status |
|---|---|---|
| Echo Dot (2nd gen) | MediaTek MT8163, about 480 MB of memory | Supported, in early development |
| Echo (2nd gen) | The same MT8163 platform | Supported, in early development |
It needs an unlocked bootloader. Pinna installs over fastboot on a device unlocked with amonet and Kaeru. Holding Volume Down while you plug the device in always opens fastboot.
You provide the backup. You back up your own device before you install, and you create your own signing key. The proprietary Wi-Fi firmware is included unmodified, in its own folder.
It's standard Linux. Debian trixie with systemd on a read-only root filesystem. Pinna's own programs are written in Rust.
Get started
Build, install, set up
- 1
Build the images The development shell has every tool.
just allbuilds the kernel, the root filesystem and the boot image. - 2
Install over fastboot
scripts/flash-gen2.shwrites the images, and can restore your backup later. - 3
Set it up on the dashboard Open the device's dashboard in your browser. Add the device to Home Assistant, or set up standalone mode, and say “Alexa”.
# Build (nix develop optional; it sets up every tool) nix develop just keygen just models just all # Install: hold Volume Down and plug in the device scripts/flash-gen2.sh check scripts/flash-gen2.sh root scripts/flash-gen2.sh boot
Goals
What Pinna sets out to do
Your voice goes only where you send it
The wake word runs on the device, and audio goes only to your Home Assistant or to services you set up.
Be a good Home Assistant satellite
Everything the device can do is available in Home Assistant.
Play music without getting in the way
AirPlay and Bluetooth share the audio path, and replies, announcements and timers come first.
Work without Home Assistant
In standalone mode the device is a voice assistant on its own, with the services you choose, and the voice of your AI agent.
Be safe to install and update
Every installation step can be undone, updates roll back on their own, and none installs without you.
Use standard parts
Debian, systemd and a small set of Rust programs.
Make development pleasant
One shell for every tool, and tests that run without hardware.
Stay open
All code is public. The few proprietary firmware files are included unmodified, in their own folder.
Status
Project status
What works
- The images build and boot in a virtual machine
- Updates install a kernel and a root filesystem into the second slot and roll back when they fail (tested on the Echo Dot)
- The Home Assistant connection passes tests with Home Assistant's own client library
- A complete voice request works against a simulated Home Assistant
- Standalone mode answers requests; tried on an Echo Dot (2nd gen) with OpenRouter and ElevenLabs
- On the Echo Dot, echo cancellation lowers the device's own music by 23 to 31 dB
- The dashboard sets up and controls the device from a browser on your network
- AirPlay and Bluetooth play music from phones and computers
Known gaps
- The dashboard has no login: anyone on your network can use it
- Standalone mode is new and hasn't been tried with every service yet
- With a Kaeru from before 22 October 2026, a new kernel needs fastboot
Get involved
Help with Pinna
Pinna is a small project in early development, and most of the useful work happens on real devices. You can help in three ways:
Report problems
Problems show up on real devices first. If an installation fails, the ring stays dark or the wake word doesn't trigger, open an issue with the version and the log, as Report a problem describes.
Send changes
Pinna is a small Rust workspace with standard systemd units. Experience with Rust, systemd or embedded audio helps most. Open an issue before larger changes, so that nobody does the same work twice.
Support another device
Pinna supports the Echo (2nd gen) and the Echo Dot (2nd gen). Other Echo devices need a device tree, board support and a device to test on.