Hannah — Open Source Smart-Home-Sprachassistentin

McBeath

Ich werte es testen und dann berichten, Dank die

Leonie

Dafür gibt es nun einen standalone Chat für Hannah:
https://github.com/Leonie-Network/hannah-chat/releases

Da liegen fertig kompilierte Binaries für Windows und Linux, aber "nur" 64bit. Also keine ARM-Prozessoren wie Handy oder Raspberry Pi, dafür aber Desktop Prozessoren für den heimischen PC.

Neben der Binary muss noch die Datei config.yaml existieren, deren Inhalt kann man sich hier kopieren und dann an die eigenen Gegebenheiten anpassen: https://github.com/Leonie-Network/hannah-chat/blob/main/config.example.yaml

Unterstützt wird aktuell nur der anonyme Chat. Also Hannah wird nicht wissen wer grade mit ihr spricht, aber sie wird alles tun, was quasi Gäste dürfen, also bspw. das Haus steuern oder, bei Verfügbarkeit eines LLMs, in den Smalltalmodus gehen.

Leonie

Da das Thema in letzter Zeit öfter aufkam, hier ein kurzer Einblick, warum Hannah bei manchen Setups Einfluss auf andere Dienste (wie Modbus TCP, ioBroker oder Home Assistant) zu haben scheint:

Das Problem bei Multi-Task-Hosts (z. B. Synology oder QNAP NAS / schwache Single-Board-Computer):
NAS-Systeme sind hervorragende Datengräber, Multitalente und Container-Hosts für Leichtgewichte. Reines Python verbraucht zwar kaum Ressourcen, aber sobald im Hintergrund Machine-Learning-Frameworks wie PyTorch für Sprachverarbeitung und Inferenz anziehen, schießt die Last kurzzeitig extrem hoch. Wenn das zusammen mit I/O-sensiblen Diensten auf derselben Kiste läuft, teilen sich alle Prozesse dieselben CPU-Time-Slices.

Anders gesagt: Hannah ist nicht darauf ausgelegt auf NAS-Systemen stabil zu laufen, dafür ist sie zu mächtig.

Das soll nicht heißen dass die NAS-Systeme schlechte CPUs hätten, sie sind schlicht nicht für die Last gebaut.

Warum Modbus TCP dann abkackt:
Modbus-TCP-Gateways in Wechselrichtern sind extrem empfindlich. Wenn der Host-Prozess durch eine kurze CPU-Spitze oder einen kurzen Event-Loop-Stall (z. B. bei der Verarbeitung von Requests) für wenige Sekunden keine Zeit abbekommt, rennt der Modbus-Poll in einen Timeout. Das Ergebnis sind hässliche Aussetzer und Lücken im Diagramm.

Empfehlung für die Praxis:

Netzwerk & Hardware trennen: Wenn Hannah auf einer Synology läuft, sollte man der NAS entweder ausreichend CPU/RAM-Reserven gönnen oder Hannah auf eine eigene dedizierte Hardware (z. B. ein separates System / NUC / Raspi) auslagern.
Keine Modbus-Direktabfragen: Hannah sollte selbst niemals direkt Ressourcen pollen, sondern Daten passiv/push-getrieben aus eurem Smart-Home-System beziehen.
System-Monitoring: Bei Lücken in anderen Diensten immer erst htop / docker stats prüfen – meist ist es ein lokaler CPU- oder I/O-Bottleneck auf dem Host und kein Fehler im Endgerät.

Leonie

Hallo zusammen,

für alle, die Hannah gerne ausprobieren oder in ihrer ioBroker-Umgebung testen möchten, aber keinen passenden ESP32 zur Hand haben und für einen Test nicht direkt durch den Dschungel der PCBA-Bestellung gehen wollen, habe ich etwas gebastelt:

Ab sofort gibt es die Hannah Desktop Satellite (Lite) Software für Windows und Linux. Damit könnt ihr euren PC oder Laptop direkt als Hannah-Satelliten nutzen.

Was kann die Software?
Die App deckt alle grundlegenden Audiofunktionen ab:

Push-to-Talk (Sprachaufnahme per Knopfdruck)
Stummschaltung (Mute)
Lautstärkeregelung

Was unterscheidet sie von den ESP-Satelliten?
Da es sich um eine schlanke Lite-Variante handelt, fehlen hardwarebasierte Zusatzfunktionen:

Kein Wakeword (Aktivierung erfolgt manuell via Push-to-Talk)
Keine integrierten Sensoren (kein Bluetooth-Tracking, keine Umweltsensoren)
Keine Steuerung von physikalischen LEDs
Kein Over-the-Air (OTA) Update

Ein paar Worte zur Zukunft & Support der Software
Damit die Erwartungen richtig gesteckt sind, hier ein kleiner Transparenz-Hinweis von meiner Seite:

Funktionsumfang: Die Software wird genau mit den oben beschriebenen Features bereitgestellt. Erweitert wird sie um keine weiteren Funktionen – für das volle Hannah-Erlebnis mit Wakeword und Sensorik sind weiterhin die ESP-Satelliten gedacht.
Wartung & Stabilität: Da die Kommunikationsschnittstelle seit mehreren Wochen eingefroren und stabil ist, erwarte ich in den kommenden Monaten hier keine Umbrüche. Ich werde auftretende Bugs im Blick behalten und dafür sorgen, dass die Lite-Software funktionstüchtig bleibt und an künftige Hannah-Anpassungen angeglichen wird.
Langzeit-Perspektive: Ich pflege die Software nach meinen zeitlichen Möglichkeiten. Solange sie ihren Zweck als unkomplizierter Test-Satellit erfüllt, bleibt sie euch natürlich erhalten.

Den Download findet ihr hier: https://github.com/Leonie-Network/hannah-satellite-lite/releases

Für die Installation einfach die gewünschte Datei (für Windows oder Linux) runterladen und die config.yaml daneben legen. Eine Beispielconfig findet ihr dort: https://raw.githubusercontent.com/Leonie-Network/hannah-satellite-lite/refs/heads/main/config.example.yaml Diese müsst ihr an eure Installation anpassen.

Die Software benötigt einen laufenden Hannah-Core, ob über Docker oder die native Installation ist egal.

Mal angenommen ihr seid auf Windows unterwegs dann ladet ihr zum Zeitpunkt dieses Posts diese Datei herunter: hannah-satellite-lite-v0.0.2-windows-amd64.exe. Dann öffnet ihr ein Terminal (Powershell oder Eingabeaufforderung) und wechselt an den Ort wo die herungeladene Datei liegt.
Dann gebt ihr ein:

.\hannah-satellite-lite-v0.0.2-windows-amd64.exe --config config.yaml

Probieren geht über Studieren – schaut sie euch gerne an und gebt Feedback, wie der Einstieg geklappt hat!

Liebe Grüße

micklafisch

@McBeath
ich versuche mich gerade an der Installation von Hannah auf einer Syno. Läuft bei dir das ganze nun mit Port 5000? Bei mir schlägt der Start vom Container webui fehl, da der Port bereits durch die Syno belegt ist. Deine Aussage war ja nach einem zurück auf 5000 läuft es?!

Leonie

Die synology nutzt den Port 5000 selbst, genau wie auch Port 5001. Änder den Port einfach auf irgendeinen anderen, 5003 bspw.

micklafisch

ja, mich wundert nur die Aussage von @McBeath dass es bei Port 5000 nun bei ihm läuft. Danke, du bist echt flott

micklafisch

der Container für die Core stürzt permanent ab, Fehlermeldung "access denied". Ich hatte aus der Doku die compose.yaml erstellt und verwendet.

2026/09/23 15:42:34	stderr	mysql.connector.errors.ProgrammingError: 1045 (28000): Access denied for user 'hannah_user'@'172.22.0.4' (using password: YES)
2026/09/23 15:42:34	stderr	    ) from err
2026/09/23 15:42:34	stderr	        err.errno, msg=err.msg, sqlstate=err.sqlstate
2026/09/23 15:42:34	stderr	    raise get_mysql_exception(
2026/09/23 15:42:34	stderr	  File "/usr/local/lib/python3.14/site-packages/mysql/connector/connection_cext.py", line 360, in _open_connection
2026/09/23 15:42:34	stderr	    ~~~~~~~~~~~~~~~~~~~~~^^
2026/09/23 15:42:34	stderr	    self._open_connection()
2026/09/23 15:42:34	stderr	  File "/usr/local/lib/python3.14/site-packages/mysql/connector/abstracts.py", line 1604, in connect
2026/09/23 15:42:34	stderr	    ~~~~~~~~~~~~^^^^^^^^^^
2026/09/23 15:42:34	stderr	    self.connect(**kwargs)
2026/09/23 15:42:34	stderr	  File "/usr/local/lib/python3.14/site-packages/mysql/connector/connection_cext.py", line 142, in __init__
2026/09/23 15:42:34	stderr	    return CMySQLConnection(*args, **kwargs)
2026/09/23 15:42:34	stderr	  File "/usr/local/lib/python3.14/site-packages/mysql/connector/pooling.py", line 322, in connect
2026/09/23 15:42:34	stderr	           ~~~~~~~~~~~~~~~~~~~~~~~^^^^^^^^^^
2026/09/23 15:42:34	stderr	    return mysql.connector.connect(**kwargs)
2026/09/23 15:42:34	stderr	  File "/usr/local/lib/python3.14/site-packages/pyorm/dialects/mysql.py", line 26, in connect
2026/09/23 15:42:34	stderr	               ~~~~~~~~~~~~~~~^^^^^^^^^^
2026/09/23 15:42:34	stderr	    return cls(dialect.connect(**kwargs), dialect)
2026/09/23 15:42:34	stderr	  File "/usr/local/lib/python3.14/site-packages/pyorm/database.py", line 32, in mysql
2026/09/23 15:42:34	stderr	    ^
2026/09/23 15:42:34	stderr	    )
2026/09/23 15:42:34	stderr	        ^^^^^^^^^^^^^^^^^^^^^^^^^^
2026/09/23 15:42:34	stderr	        database=_cfg["database"],
2026/09/23 15:42:34	stderr	    ...<3 lines>...
2026/09/23 15:42:34	stderr	        ^^^^^^^^^^^^^^^^^^
2026/09/23 15:42:34	stderr	        host=_cfg["host"],
2026/09/23 15:42:34	stderr	           ~~~~~~~~~~~~~~^
2026/09/23 15:42:34	stderr	    return Database.mysql(
2026/09/23 15:42:34	stderr	  File "/app/hannah/utils/activity_db.py", line 50, in get_activity_db
2026/09/23 15:42:34	stderr	    db = get_activity_db()
2026/09/23 15:42:34	stderr	  File "/app/hannah/utils/activity_db.py", line 39, in init_activity_db
2026/09/23 15:42:34	stderr	    ~~~~~~~~~~~~~~~~^^^^^^^^^^^^^^^^^^
2026/09/23 15:42:34	stderr	    init_activity_db(activity_log_cfg)
2026/09/23 15:42:34	stderr	  File "/app/main.py", line 150, in main
2026/09/23 15:42:34	stderr	    ~~~~^^
2026/09/23 15:42:34	stderr	    main()
2026/09/23 15:42:34	stderr	  File "/app/main.py", line 2696, in <module>
2026/09/23 15:42:34	stderr	Traceback (most recent call last):
2026/09/23 15:42:34	stderr	
2026/09/23 15:42:34	stderr	The above exception was the direct cause of the following exception:
2026/09/23 15:42:34	stderr	
2026/09/23 15:42:34	stderr	_mysql_connector.MySQLInterfaceError: Access denied for user 'hannah_user'@'172.22.0.4' (using password: YES)
2026/09/23 15:42:34	stderr	    ~~~~~~~~~~~~~~~~~~~~^^^^^^^^^^^^^^
2026/09/23 15:42:34	stderr	    self._cmysql.connect(**cnx_kwargs)
2026/09/23 15:42:34	stderr	  File "/usr/local/lib/python3.14/site-packages/mysql/connector/connection_cext.py", line 354, in _open_connection
2026/09/23 15:42:34	stderr	Traceback (most recent call last):
2026/09/23 15:42:33	stderr	13:42:33 [INFO] hannah.main: Hannah Core dev

Leonie

Zeige mir bitte die generierte compose.yaml. gerne auch per Chat

Leonie

Heyy,

ich habe gute Neuigkeiten für alle, die ihren Hannah-Account mit Telegram verbinden möchten!

Bisher gab es da ja ein paar Hürden, aber das gehört ab sofort der Vergangenheit an: Es wird ab sofort weder HTTPS noch eine eigene Domain benötigt.

Was ist neu?
Mit der neuen Version entfallen die merkwürdigen Anforderungen seitens Telegram komplett. Der Ablauf ist jetzt extrem simpel:

In der WebUI klickt ihr einfach auf „Verbinden“.
Ihr werdet direkt zu Telegram weitergeleitet und erhaltet dort einen Einladungslink für den Chat mit dem Bot.
Sobald ihr den Chat startet, wird euer Account automatisch verbunden.

Kurzum: Für alle deutlich einfacher und unkomplizierter einzurichten!

Voraussetzungen
Damit das reibungslos funktioniert, müsst ihr folgende Versionen (oder neuer) einsetzen:

Hannah Core / Telegram: v0.85.0
Hannah WebUI: v2.8.0
Hinweis: hannah-telegram muss natürlich gestartet sein und über einen gültigen Bot-Token verfügen.

Bezugsquellen
Die aktuellen Versionen stehen ab sofort bereit:

Wie gewohnt auf meinem Update-Server
Für alle Docker-Nutzer als Image auf quay.io

Testet es gerne aus und gebt Bescheid, falls Fragen oder Feedback auftauchen!

Viel Spaß damit!

Walter.O.

Krass Leonie, damit hat es auch bei mir Jetzt Funktioniert. Du Bist echt Super.

Walter.O.

Mal eine Frage an euch.
ist das alles so Richtig, das hannah dieses Gerät Finden müsste oder habe ich wieder einen Denkfehler?
Oder muss ich die Einstellungen für ein Gerät noch woanders eingeben.

Leonie

Zeig mal bitte die Adapter-Einstellungen. Ich denke da fehlt die die Raum- und Funktionsauswahl

Walter.O.

Leonie

Dir fehlt mindestens die Funktion Engine. Die hat dein State zugewiesen. Wähle die also noch aus, drücke auf Speichern und Hannah sollte das Gerät finden.

Walter.O.

@Leonie

Sep 23 21:32:40 iob python[1959373]: 21:32:40 [INFO] hannah.grpc_server: [grpc] Channel-Adapter registriert: 'telegram' (version='', verknüpfbar=True)
Sep 23 21:33:00 iob python[1959373]: 21:33:00 [INFO] hannah.grpc_server: [grpc] SubmitText von telegram:5160868646 (user=2) — 'Schalte im Wohnzimmer Tablett laden ein'
Sep 23 21:33:00 iob python[1959373]: 21:33:00 [INFO] hannah.main: [textcmd] Text: 'Schalte im Wohnzimmer Tablett laden ein' → Intent: Unknown | Raum: Wohnzimmer | Gerät: Tablett laden | Wert: None | SpeakerUser: 2
Sep 23 21:33:00 iob python[1959373]: 21:33:00 [INFO] hannah.tool_agent: [tool_agent] Iteration 1/5 — payload 2 msgs / ~763 chars
Sep 23 21:33:00 iob python[1959373]: 21:33:00 [INFO] hannah.tool_agent: [tool_agent] finish_reason=stop tool_calls=0
Sep 23 21:33:00 iob python[1959373]: 21:33:00 [INFO] hannah.main: [2] Antwort (Unknown): 'Das kann ich leider nicht beantworten.'

Leonie

Das hat sie nicht verstanden. Probier bitte mal die Form "Schalte im Wohnzimmer Tablett laden an"

Walter.O.

Ja Stimmt kaum macht mans Richtig, Gehts...

Leonie

Wenn deine WebUI läuft, kannst du in der in den Settings die turn_on wörter bearbeiten und "ein" einfach dazuschreiben

Walter.O.

Weiß jemand was man bei einem Shelly: shellyplus2pm alles wo einstellen muss und wo solll das zahnrad hin

Community Forum

NEWS

Hannah — Open Source Smart-Home-Sprachassistentin

Support us

473

33.1k

83.9k

1.4m