🔍
1. Schnittstelle
Dokumentation, Netzwerkverkehr, API-Endpunkte oder vorhandene Bibliotheken prüfen. Ohne belastbaren Kommunikationsweg kann auch die beste Integration nichts steuern.
FOLGE 8 · PROFITIPP
Home Assistant Custom Integration mit ChatGPT erstellen
Dein Gerät kann mehr, als Home Assistant dir zeigt – oder es gibt gar keine passende Integration? Dann kann eine Custom Integration die Lücke schließen. Du musst dafür nicht plötzlich zum Vollzeitentwickler werden: Wir zerlegen die Aufgabe in kleine, prüfbare Schritte und nutzen ChatGPT als Helfer.
Der häufigste Fehler wäre, ChatGPT einfach „Bau mir eine Integration“ hinwerfen zu lassen. Besser: zuerst klären, wie das Gerät erreichbar ist, welche Werte und Befehle es gibt und welche Funktionen Home Assistant daraus bekommen soll.
Eine eigene Erweiterung unter custom_components
Home Assistant lädt benutzerdefinierte Integrationen aus dem Ordner /config/custom_components. Jede Integration bekommt dort einen eigenen Domain-Ordner. Die offizielle Entwicklerdokumentation verlangt unter anderem eine manifest.json; bei Custom Integrations ist außerdem eine Versionsangabe nötig.
Offizielle Home-Assistant-Dokumentation zum Integration Manifest →
/config/custom_components/mein_geraet/ ├── __init__.py ├── manifest.json ├── config_flow.py # wenn Einrichtung über die Oberfläche gewünscht ist ├── const.py ├── coordinator.py # häufig für gemeinsamen Datenabruf ├── sensor.py # falls Sensoren bereitgestellt werden └── strings.json # Texte für die Oberfläche
Welche Dateien wirklich nötig sind, hängt vom Gerät ab. Eine reine Sensor-Integration braucht etwas anderes als ein Media Player, Climate-Gerät oder eine Integration mit mehreren Plattformen.
In fünf Schritten zur eigenen Home-Assistant-Integration
- Schnittstelle finden: lokale API, HTTP, TCP, UDP, MQTT, serielle Verbindung oder Hersteller-Cloud?
- Ziel festlegen: Welche Werte sollen als Sensor erscheinen, welche Funktionen sollen schaltbar sein?
- Struktur bauen: Domain,
manifest.json, Einrichtung und Entitäten sauber planen. - Mit ChatGPT Datei für Datei entwickeln: kleine Schritte statt eines riesigen Codeblocks.
- Testen und Logs lesen: Neustart, Integration laden, Fehler prüfen, genau eine Ursache nach der anderen beheben.
Ich möchte für Home Assistant eine eigene Custom Integration bauen. Gerät: [Hersteller und Modell] Verbindung: [LAN / WLAN / API / TCP / MQTT / unbekannt] Bekannte Schnittstelle oder Befehle: [hier einfügen] Ich möchte in Home Assistant: - [gewünschte Sensoren] - [gewünschte Schalter/Funktionen] - [weitere Funktionen] Arbeite mit mir schrittweise. Erstelle nicht sofort die komplette Integration. 1. Prüfe zuerst, welche Informationen uns noch fehlen. 2. Schlage danach die passende Home-Assistant-Struktur vor. 3. Erkläre jede Datei kurz, bevor du Code dafür erstellst. 4. Nutze aktuelle Home-Assistant-Konventionen. 5. Nach jedem Schritt soll ich testen können, bevor wir weitermachen.
Damit zwingst du die KI zu einem nachvollziehbaren Ablauf. Gerade bei Geräten mit unbekannten Netzwerkbefehlen ist das entscheidend: Erst Kommunikation beweisen, dann Home-Assistant-Code darum bauen.
🧱
2. Kleine Bausteine
Zuerst Verbindung und einen einzigen Wert zuverlässig lesen. Danach weitere Entitäten und Funktionen ergänzen.
🧪
3. Testen
Home-Assistant-Logs und echte Geräteantworten sind wichtiger als Vermutungen. Fehler immer an der ersten klaren Ursache beheben.
Genau so sind unsere eigenen Speziallösungen entstanden: beim Acer-Projektor und beim Onkyo-Receiver ging es nicht darum, möglichst viel Code auf einmal zu erzeugen. Entscheidend war, Befehle und Rückmeldungen systematisch zu testen und daraus Schritt für Schritt eine brauchbare Home-Assistant-Anbindung zu bauen.
Kann ChatGPT eine Home Assistant Integration komplett für mich bauen?
ChatGPT kann sehr viel Vorarbeit übernehmen: Struktur planen, Python-Code schreiben, Fehler erklären und Änderungen vorschlagen. Ob die Integration wirklich funktioniert, entscheidet aber immer das echte Gerät zusammen mit Home Assistant. Deshalb testen wir jeden Schritt.
Wo installiere ich eine Custom Integration?
Typischerweise unter /config/custom_components/deine_domain/. Danach muss Home Assistant die neue Integration laden; je nach Aufbau ist dafür ein Neustart nötig.
Was gehört in die manifest.json?
Sie beschreibt die Integration, unter anderem Domain, Name und weitere Metadaten. Für Custom Integrations ist eine Version erforderlich. Welche zusätzlichen Angaben sinnvoll oder nötig sind, hängt von der Integration ab.
Wenn du mit ESP32 oder eigenen Sensoren starten willst, beginne mit ESPHome mit Home Assistant für Anfänger. Für eine fertige Logik in Alltagssprache zeigen wir außerdem, wie du eine Home Assistant Automation mit ChatGPT erstellst. Und wenn etwas nicht funktioniert, hilft unsere Anleitung Home Assistant Fehler mit ChatGPT finden.
Dann starte vorne: Was ist überhaupt eine Home Assistant Integration? Oder gehe zur Übersicht der kompletten Integrations-Serie.
Für den nächsten Schritt helfen besonders die verschiedenen Integrations-Arten und unsere Anleitung Integration in Home Assistant einbauen. So wird aus der Theorie ein sauberer Installationsweg.
Hat das Gerät eine erreichbare Hardware-Schnittstelle, kann ein ESP32 die einfachere Brücke sein. Eigene ESPHome-Lösung mit KI →