Vor der Installation: prüfe, ob deine Anlage passt

In fünf Schritten zu deiner ersten Prognose

Voraussetzung ist Home Assistant 2026.3.0 oder neuer und die aktuelle PV-Leistung jeder aktiven Modulgruppe. Bereite zuerst die wenigen wirklich notwendigen Angaben vor. Danach führt dich HACS zur Installation und der Home-Assistant-Dialog durch die Einrichtung.

  1. 01
    Vorbereitung

    Sensoren und Anlagendaten bereitlegen

    Notiere für jede aktive Modulgruppe den Live-Leistungssensor, die installierte Leistung in kWp, den Azimut und die Neigung.

  2. 02
    HACS

    Repository in HACS hinzufügen

    Öffne HACS → Integrationen → Benutzerdefinierte Repositories. Füge die GitHub-Adresse als Kategorie Integration hinzu.

    https://github.com/Zara-Toorox/ha-solar-forecast-ml
  3. 03
    Download

    Solar Forecast ML installieren

    Suche in HACS nach Solar Forecast ML, öffne den Eintrag und starte den Download der Integration.

  4. 04
    2 Neustarts

    Home Assistant kontrolliert neu starten

    Starte Home Assistant nach der Installation neu, warte 10 bis 15 Minuten und führe anschließend den zweiten Neustart aus.

  5. 05
    Config Flow

    Integration einrichten und Werte prüfen

    Öffne Einstellungen → Geräte & Dienste → Integration hinzufügen. Wähle Solar Forecast ML und ordne jede Modulgruppe ihrem Leistungssensor zu.

Bevor du die Installation als fertig betrachtest

  • ✓Die aktuellen Leistungen der Modulgruppen sind plausibel
  • ✓Gesamtleistung und erste Prognosesensoren sind vorhanden
  • ✓Diagnosesensoren melden keine fehlende Pflichtangabe

Erst das Fundament, dann die Erweiterungen

SFML wird zuerst vollständig eingerichtet. Danach ergänzt du nur die Komponenten, die zu deinem Energiesystem passen. EAI steht bewusst direkt neben STATS, weil beide aufeinander aufbauen.

01 · Nach SFML

Solar Forecast STATS

Macht Prognose, Erzeugung und Energieflüsse sichtbar. Für die Grundkonfiguration wird der aktuelle Hausverbrauch benötigt.

SFML eingerichtetHausverbrauch in W oder kWx86_64
02 · Nach SFML und STATS

Solar Forecast EAI

Aktiviert mit einer gültigen Lizenz den lokalen Kepler-AI-Stack und das Energy Management System für Wärme, Speicher, Wallbox und erklärbare Energiesignale.

SFML + STATSEAI-LizenzEnergiemanagement
03 · Im EAI-Lizenzpaket

Grid Price Monitor

Ab V46.2.0 ist GPM die einzige Quelle für Strompreise und Wirtschaftlichkeit. Tarife werden nur noch in GPM konfiguriert, nicht in STATS; vorhandene Werte werden automatisch übernommen.

EAI-LizenzTarife nur in GPMAutomatische Migration
04 · Eigenständig

Weather Fusion AI

Benötigt lokale Wettermesswerte am tatsächlichen Standort. Eine entfernte Station sollte nicht als lokale Messung nachgebildet werden.

Eigene WetterstationLokale MesswerteKeine Remote-Nachbildung
05 · Separates Add-on

Toorox ForeSight HA

Wird über den Home-Assistant Add-on Store installiert und ergänzt eine bereits funktionierende SFML-Installation um Phoenix V2.

SFML eingerichtetAdd-on StoreZusätzliches KI-Signal

Einrichtungsbeispiel Wärmepumpe

Die Wärmepumpe wird zuerst in STATS als elektrischer Verbraucher erfasst. EAI ergänzt anschließend Wetter-, Gebäude- und Betriebsdaten für Prognosen und erklärbare Empfehlungen.

Die wichtigste Regel

Aktuelle Leistung und Tagesenergie sind zwei verschiedene Messgrößen. Verwende für die Leistung einen Sensor in W oder kW. Die Tagesenergie muss seit Mitternacht in kWh zählen und täglich zurückgesetzt werden. Einen seit Inbetriebnahme steigenden Gesamtzähler ordnest du niemals direkt als Tagesenergie zu.

  1. 01
    STATS

    Wärmepumpe in STATS anlegen

    Öffne Solar Forecast STATS → Neu konfigurieren → Verbraucher. Ordne unter Wärmepumpenleistung die aktuelle elektrische Aufnahme der gesamten Wärmepumpe zu. Verwende keine thermische Leistung und keinen kWh-Zähler.

  2. 02
    EAI BASIS

    Pflichtbasis in EAI zuordnen

    Öffne Solar Forecast EAI → Neu konfigurieren → Wärmepumpe. Ordne aktuelle elektrische Leistung, Wärmepumpenenergie heute und Außentemperatur zu. Diese drei Werte bilden die Grundinstallation.

  3. 03
    HOME ASSISTANT

    Tageszähler korrekt erzeugen

    Stellt deine Anlage nur einen Lebenszeit-Energiezähler bereit, erstelle in Home Assistant einen Verbrauchszähler mit täglichem Rückstellzyklus. Wähle ausschließlich diesen Tageszähler als Wärmepumpenenergie heute.

  4. 04
    OPTIONAL

    Kontext ergänzen und Ergebnis prüfen

    Innentemperatur, Betriebsmodus, Verdichterstatus, Vorlauf, Rücklauf und Warmwassertemperatur verbessern Erklärbarkeit und Genauigkeit. Prüfe danach Datenqualität, Modellstatus und die bereitgestellten passiven Empfehlungssensoren.

Welche Sensoren gehören wohin

FeldErwarteter WertBedeutung
heat_pump_power_sensorW · kW · MWErforderlich · aktuelle elektrische Aufnahme
heat_pump_energy_today_sensorWh · kWh · MWh seit 00:00 UhrErforderlich · Tagesverbrauch und Lernziel
outdoor_temperature_sensor°C · °FErforderlich · Wetter- und Wärmebedarfskontext
indoor_temperature_sensor°C · °FOptional · Komfort und Gebäudereaktion
operation_mode_sensorStabiler TextzustandOptional · Heizen, Warmwasser oder Aus
compressor_sensorEin/Aus · 0/1Optional · reale Verdichterlaufzeit
flow_temperature_sensor / return_temperature_sensor°C · °FOptional · Spreizung und Effizienzeinordnung
dhw_temperature_sensor°C · °FOptional · Warmwasserbedarf und Speicherzustand
thermal_energy_sensor / jaz_sensorEnergie · dimensionslose KennzahlOptional · thermische Effizienz

Bevor du EAI bewertest

  • ✓Leistung steigt sichtbar, wenn der Verdichter läuft
  • ✓Tagesenergie steigt in kWh und beginnt nach Mitternacht wieder nahe null
  • ✓Elektrischer Wärmepumpenzähler und Heizstab werden nicht doppelt gezählt
  • ✓Vorlauf und Rücklauf stammen aus demselben hydraulischen Messkreis
  • ✓EAI berät und stellt Signale bereit – geschaltet wird nur durch deine eigene Home-Assistant-Automation
Alle benötigten und optionalen EAI-Sensoren ansehen