Komponenten¶
Hannah besteht aus mehreren eigenständigen Diensten. Was du davon wirklich brauchst, steht in der Tabelle unten.
Die Karte zeigt, wie die Komponenten zusammenhängen — Details zu jeder einzelnen stehen in der Tabelle darunter.
| Komponente | Zweck | Brauche ich das? | Aktuelle Version |
|---|---|---|---|
| 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) | – |
| Asset Server | Liefert Sound-Assets (Klingeln, Hinweistöne) an die Satelliten aus | Ja (für Sound-Feedback) | – |
| Proxy | Nimmt Core die UDP-Audio-Verarbeitung der Satelliten ab — sinnvoll, wenn viele Satelliten Core sonst zu sehr belasten würden | Bei Bedarf | – |
| Telegram | Hannah per Telegram-Chat ansprechen, als eigener Prozess | Bei Bedarf | – |
| Chat (Terminal) | Hannah am PC per Tastatur schreiben, direkt im Terminal | Bei Bedarf | – |
| Microsoft Teams | Hannah per Teams-Chat anschreiben — muss aus dem Internet erreichbar sein | Bei Bedarf | – |
| VoiceID | Erkennt, wer spricht, nicht nur was gesagt wurde | Bei Bedarf (hilfreich aber immer) | – |
| Timer | Timer und Wecker | Empfohlen | – |
| AutoDeploy | Hält die anderen Komponenten automatisch aktuell | Empfohlen | – |
| Update-Server | Die Quelle, von der Installationen, AutoDeploy und die Satelliten-Firmware ihre Releases beziehen | — (kein eigener nötig) | – |
| LogCollector | Sammelt die Logs aller Komponenten an einem Ort — erleichtert die Fehlersuche | Empfohlen | – |
| 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.