Overview
What Pinna is, its two modes, and where to start.
Pinna is an open-source operating system for the Echo (2nd gen) and the Echo Dot (2nd gen). It turns the device into a voice satellite: you say the wake word, and the device 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. The wake word detection runs on the device, and Pinna doesn’t use Amazon’s services.
Early development. Pinna works, but it installs only on a device whose bootloader is unlocked, and until 1.0 it can change from one release to the next. See Status and roadmap.
How it works
- Pinna listens for a wake word on the device: Alexa, unless you choose others. Until it hears one, no audio leaves the device.
- It sends your request to the assistant you chose, which turns the speech into text, handles the request and creates the spoken reply.
- The device plays the reply. The light ring shows each step.
You set up the satellite on its dashboard, a web page that the device serves to your network. Every setting is there, in both modes.
Two modes
On the dashboard’s Assistant page you choose who answers requests. You can switch at any time.
| Home Assistant mode | Standalone mode | |
|---|---|---|
| What answers | Your Assist pipeline in Home Assistant | Speech-to-text, a brain and text-to-speech that you set up on the dashboard. The brain is a language model or an AI agent such as Hermes or OpenClaw |
| What you need | Home Assistant on your network | An account with a hosted service, or your own servers on your network |
| Timers | Home Assistant’s, shown on the ring | The satellite’s own, shown on the ring |
| Automations | The ring, the buttons, mute, volume, timers and a media player are Home Assistant entities | Your AI agent can use the satellite over MCP. Home Assistant can stay connected for its entities |
| Set it up | Connect to Home Assistant | Set up standalone mode |
A new satellite starts in Home Assistant mode.
Both modes have the same ring and buttons, the wake word tuning, music over AirPlay, Bluetooth and Sendspin, and updates that go back to the previous version if the new one doesn’t start.
Where to start
To install and set up Pinna, follow these pages in order:
- Echo devices: check that Pinna runs on your Echo.
- What you need: the device, the computer and a backup.
- Install Pinna: from the browser with the installer, or from a terminal over fastboot. Then connect the device to Wi-Fi.
- Set up the satellite: open its dashboard, and name it.
- Choose who answers: connect to Home Assistant, or set up standalone mode.
If something goes wrong, see Troubleshooting and Recover a device.
Learn more
- Goals: what Pinna sets out to do, and what it doesn’t.
- Architecture: how the system starts and runs.
- Contribute: work on Pinna. The developer pages cover
building, the configuration file,
pinnactl, the control API and releases.