Komponenten

Hannah besteht aus mehreren eigenständigen Diensten. Core und die WebUI sind zwingend nötig — alles andere ist optional und wird bei Bedarf dazugeschaltet.

Die Karte zeigt, wie die Komponenten zusammenhängen — Details zu jeder einzelnen stehen in der Tabelle darunter.

Durchgezogener Rand = Pflicht (bzw. für Smart-Home-Steuerung nötig), gestrichelter Rand = optional. Satelliten sprechen immer mit Core — der Proxy kann sich optional dazwischenschalten. Core wiederum verbindet sich mit der WebUI und dem ioBroker-Adapter sowie optional mit Telegram, VoiceID und dem Timer.

Komponente	Zweck	Pflicht?
Core	Das Herzstück: STT, NLU, TTS, Geräte-Steuerung, Orchestrierung. Alle anderen Komponenten sprechen mit ihr.	Ja
WebUI	Web-Oberfläche zur Steuerung und Konfiguration	Ja
Satellit	ESP32-S3-Hardware, nimmt Sprachbefehle auf	Ja (mind. einer)
Proxy	Nimmt Core die UDP-Audio-Verarbeitung der Satelliten ab — sinnvoll, wenn viele Satelliten Core sonst zu sehr belasten würden	Nein
Telegram	Hannah per Telegram-Chat ansprechen, als eigener Prozess	Nein
VoiceID	Erkennt, wer spricht, nicht nur was gesagt wurde	Nein
Timer	Timer und Wecker	Nein
AutoDeploy	Hält die anderen Komponenten automatisch aktuell	Nein
Update-Server	Die Quelle, von der Installationen, AutoDeploy und die Satelliten-Firmware ihre Releases beziehen	— (kein eigener nötig)
ioBroker-Adapter	Bindet Hannah an ioBroker an — ohne ihn keine Smart-Home-Steuerung	Ja (für Smart-Home-Steuerung)

macOS

Native Installation unter macOS gibt es bislang nur für AutoDeploy und VoiceID. Für alle anderen Komponenten: Linux (nativ) oder Docker.