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.
- 01Vorbereitung✓
Sensoren und Anlagendaten bereitlegen
Notiere für jede aktive Modulgruppe den Live-Leistungssensor, die installierte Leistung in kWp, den Azimut und die Neigung.
- 02HACS✓
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↗ - 03Download✓
Solar Forecast ML installieren
Suche in HACS nach Solar Forecast ML, öffne den Eintrag und starte den Download der Integration.
- 042 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.
- 05Config 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.

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

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.

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.

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

Toorox ForeSight HA
Wird über den Home-Assistant Add-on Store installiert und ergänzt eine bereits funktionierende SFML-Installation um Phoenix V2.
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.
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.
- 01STATS
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.
- 02EAI 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.
- 03HOME 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.
- 04OPTIONAL
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
heat_pump_power_sensorW · kW · MWErforderlich · aktuelle elektrische Aufnahmeheat_pump_energy_today_sensorWh · kWh · MWh seit 00:00 UhrErforderlich · Tagesverbrauch und Lernzieloutdoor_temperature_sensor°C · °FErforderlich · Wetter- und Wärmebedarfskontextindoor_temperature_sensor°C · °FOptional · Komfort und Gebäudereaktionoperation_mode_sensorStabiler TextzustandOptional · Heizen, Warmwasser oder Auscompressor_sensorEin/Aus · 0/1Optional · reale Verdichterlaufzeitflow_temperature_sensor / return_temperature_sensor°C · °FOptional · Spreizung und Effizienzeinordnungdhw_temperature_sensor°C · °FOptional · Warmwasserbedarf und Speicherzustandthermal_energy_sensor / jaz_sensorEnergie · dimensionslose KennzahlOptional · thermische EffizienzBevor 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
