Hannah

Hannah is a self-hosted, German-speaking voice assistant for the smart home — a locally run replacement for Google Assistant or Amazon Echo. It runs on a Raspberry Pi and integrates with ioBroker. Satellites are custom ESP32-S3 devices that pick up wake word / push-to-talk voice commands and send them to Hannah Core.

This site documents Hannah's architecture, hardware, and components for anyone who wants to build one themselves or contribute.

Where to start

• Architecture — how the pieces talk to each other
• Hardware — the satellite PCB and enclosure
• Development — setting up a dev environment
• Services — the components that make up the system

Repositories

• hannah — Core, satellite firmware, and supporting services (public mirror)
• hannah-proto — the gRPC protocol shared by every component
• AudioLib — audio processing library used by the satellite firmware
• ioBroker.hannah — the ioBroker adapter

Found something outdated or missing? PRs against this repo are welcome.