LawnAI

KI-gestützter Rasenpflege-Assistent für Home Assistant. LawnAI wertet Wetter- und Sensordaten aus, erstellt per Anthropic Claude oder OpenAI eine Pflegeempfehlung inkl. 7-Tage-Plan und kann Mähroboter sowie Bewässerung automatisch zum passenden Zeitpunkt starten.

Domain-Name der Integration: lawnai.

Funktionsumfang

• KI-Analyse: Bewertet den Rasenzustand (Score 0–100) auf Basis von Bodentemperatur/-feuchte, Lufttemperatur, Wettervorhersage, Rasentyp und bisheriger Pflegehistorie – liefert eine Textempfehlung, nächste Aktionen und einen 7-Tage-Plan.
• Echte Wetterdaten: Boden-/Lufttemperatur vom Deutschen Wetterdienst (DWD), Vorhersage über eine vorhandene Home-Assistant-Wetterentität oder als Fallback über Open-Meteo – beides ohne API-Key.
• Automatischer Scheduler: Tägliche KI-Analyse zu einer konfigurierbaren Uhrzeit sowie automatisches Starten geplanter Mäh-/Bewässerungsaktionen zum von der KI vorgeschlagenen Zeitpunkt, unter Berücksichtigung konfigurierter Sperrzeiten.
• Aktivitäten-Log: Mähen, Düngen, Vertikutieren, Aerifizieren, Sanden, Bewässern, Skarifizieren, Unkraut-/Moosbekämpfung, Nachsäen – protokollierbar über Services oder die Lovelace-Karte, auch rückwirkend mit eigenem Datum.
• Grünlandtemperatursumme (GTS): Wird laufend aus stündlichen DWD-Werten seit dem 1. Januar berechnet und anhand der Wettervorhersage 14 Tage in die Zukunft projiziert – fließt als Kontext in die KI-Analyse ein (u. a. für den optimalen ersten Düngetermin im Frühjahr).
• Lovelace-Karte: Dashboard-Widget mit Score, Empfehlung, Automation-Status, Aktivitätserfassung, 7-Tage-Plan und Historie – inkl. eigenem Karten-Editor, keine YAML-Konfiguration nötig. Passt sich automatisch an dein Home-Assistant-Theme an (hell/dunkel, Akzentfarbe). Die Integration liefert die Karte selbst aus und registriert sie beim Start automatisch als Lovelace-Ressource.
• Heuristischer Fallback: Ist keine KI konfiguriert oder die API nicht erreichbar, liefert eine einfache Regel-Heuristik weiterhin eine Einschätzung.

Voraussetzungen

• Home Assistant (Core mit Config-Flow-Unterstützung)
• Optional: API-Key für Anthropic oder OpenAI, falls KI-Analysen genutzt werden sollen (ohne Key läuft nur die Heuristik)
• Deutsche Postleitzahl für die DWD-Stationssuche (aktuell primär auf Deutschland ausgelegt)

Installation

Über HACS (empfohlen)

Falls HACS noch nicht installiert ist: einmalig gemäß der offiziellen HACS-Anleitung einrichten.

1. In Home Assistant: HACS → Integrationen → ⋮ (oben rechts) → Benutzerdefinierte Repositories.
2. Repository-URL https://github.com/tommy0code/lawnai eintragen, Kategorie Integration wählen, hinzufügen.
3. LawnAI in der HACS-Liste suchen und über Herunterladen installieren.
4. Home Assistant neu starten.
5. Zukünftige Updates zeigt HACS automatisch an – ein Klick auf Update genügt, danach Home Assistant neu starten.

Manuell (Alternative ohne HACS)

1. Ordner custom_components/lawnai/ nach <Home-Assistant-Config>/custom_components/lawnai/ kopieren (z. B. aus dem lawnai.zip eines Releases oder direkt aus einem git clone).
2. Home Assistant neu starten. Die Karte wird von der Integration selbst ausgeliefert, ein separater Kopierschritt oder eine manuelle Lovelace-Ressource sind nicht nötig.

Einrichtung

1. Einstellungen → Geräte & Dienste → Integration hinzufügen → „LawnAI".
2. Postleitzahl, Land, KI-Provider (off / anthropic / openai) und ggf. API-Key eintragen. Das KI-Modell wird über ein Dropdown mit aktuellen Modellen ausgewählt (z. B. claude-sonnet-5, claude-opus-4-8) – eigene Modell-IDs lassen sich weiterhin frei eintippen. Änderbar jederzeit über die Integrationsoptionen (⚙️ bei der Integration).
3. Karte zu einem Dashboard hinzufügen: Kartentyp lawnai-card. Beim ersten Laden pusht die Karte ihre Konfiguration (Sensoren, Mähroboter-/Bewässerungs-Entitäten, Sperrzeiten) automatisch an die Integration.
4. Alle weiteren Einstellungen (Sensoren, Automatisierungs-Entitäten, Sperrzeiten, tägliche Analysezeit) über den Karten-Editor (✏️-Symbol) konfigurieren. Die Entitäts-Felder nutzen die native, durchsuchbare Home-Assistant-Entity-Picker-Komponente statt einfacher Dropdown-Listen.

Es ist nur eine Instanz der Integration pro Home-Assistant-Installation vorgesehen.

Mähroboter-Steuerung

Als „Mähroboter-Entität" kann entweder eine echte lawn_mower-Entität (Automower, Landroid, Gardena, …) oder eine generische Start-Entität (switch, button, automation, script) hinterlegt werden. LawnAI erkennt die Domain automatisch und ruft die passenden Services auf (lawn_mower.start_mowing/lawn_mower.pause/lawn_mower.dock bei echten Mährobotern, sonst turn_on/turn_off bzw. button.press). Bei einer echten Mähroboter-Entität zeigt die Karte deren tatsächlichen Zustand (mäht/pausiert/angedockt/fährt zur Station/Fehler) direkt an – inkl. Start-, Pause- und Dock-Button, passend zu den vom Gerät unterstützten Funktionen. Die „Schnitthöhe-Entität" ist rein optional und dient nur dazu, der KI die aktuelle Schnitthöhe als Kontext mitzugeben – sie steuert nichts.

Nutzung

Die Dashboard-Karte (lawnai-card) ist in fünf Tabs aufgeteilt:

Tab	Inhalt
Übersicht	Aktueller Rasen-Score, KI-Empfehlung, Kurzstatus (letzte Analyse, Tage seit letztem Mähen) und Button zum manuellen Starten einer KI-Analyse.
Automation	Status und manuelle Steuerung von Mähroboter und Bewässerung (Start/Pause/Stopp), abhängig von den in der Einrichtung hinterlegten Entitäten.
Aktivitäten	Pflegeaktivität erfassen (Typ auswählen, optional Schnitthöhe/Notiz/Datum). Mit dem Datumsfeld lassen sich auch vergessene, bereits erledigte Aktivitäten rückwirkend nachtragen.
Plan	Von der KI vorgeschlagene nächste Aktionen sowie ein 7-Tage-Plan.
Fehler	Von der KI erkannte Fehler in der bisherigen Pflege (z. B. Bewässern in der Mittagshitze) inkl. besserer Alternative und Begründung.
Historie	Chronologisches Protokoll aller erfassten Pflegeaktivitäten sowie vergangener KI-Analysen.

Die KI-Analyse läuft automatisch einmal täglich zur in der Karte konfigurierten Uhrzeit (Standard 07:00), zusätzlich jederzeit manuell über den Button im Übersicht-Tab oder den Service lawnai.run_analysis. Von der KI vorgeschlagene Mäh-/Bewässerungstermine werden – sofern eine entsprechende Entität konfiguriert ist – automatisch zum vorgeschlagenen Zeitpunkt gestartet, außer die Uhrzeit liegt in einer konfigurierten Sperrzeit.

Services

Service	Beschreibung
lawnai.configure	Wird von der Karte automatisch aufgerufen, um Standort, Sensoren, Zeiten und Geräte zu übergeben.
lawnai.log_activity	Protokolliert eine Pflegeaktivität (Typ, Notiz, ggf. Schnitthöhe, optional rückwirkendes Datum).
lawnai.delete_activity	Entfernt einen erfassten Aktivitäts-Eintrag wieder (per ID) – in der Karte über das ✕ an jedem Historie-Eintrag.
lawnai.run_analysis	Startet sofort eine KI-Analyse inkl. Planung von Mähen und Bewässerung.
lawnai.start_robot / lawnai.cancel_mow	Mähroboter manuell starten / abbrechen (bei echten Mährobotern: zurück zur Ladestation).
lawnai.pause_mow	Laufenden Mähvorgang pausieren (nur bei echten Mähroboter-Entitäten mit Pause-Unterstützung).
lawnai.start_irrigation / lawnai.cancel_irrigation	Bewässerung manuell starten (mit Dauer in Minuten) / abbrechen.

Diese Services lassen sich auch außerhalb der Karte nutzen, z. B. in eigenen Automatisierungen oder Skripten.

Bekannte Einschränkungen

• Primär auf Deutschland ausgelegt (DWD-Wetterdaten, deutsche UI-Texte); andere Länder nutzen automatisch den Open-Meteo-Fallback für die Vorhersage, DWD-Bodendaten sind DE-spezifisch.
• Die KI-Analyse benötigt einen API-Key eines unterstützten Anbieters (Anthropic oder OpenAI); ohne Key liefert die integrierte Heuristik nur eine grobe Einschätzung.

Lizenz

MIT