Releases: Zara-Toorox/Solar-Forecast-ML
Release list
Update V44.2.2
This updates fixes some issues with the rain-sensor handling and promotion-gate.
SFML EMS Beta
Solar Forecast PV EMS Beta starting
Fuel my late-night ideas with a coffee? I'd really appreciate it — keep this project running!
This update brings the Energy Management System with support from the local Kepler AI Stack as Beta Version 2 to your Home Assistant. As always: No Data will leave your system, no cloud, no external AI, no telemetry!
In addition, bugs in the sidebar of Solar Forecast ML have been fixed.
As summer is now coming to an end, this version also rolls out the revised Hubble AI Stack. This enables improved responsiveness to changing weather conditions. The changes incorporate the experiences and feedback from testers in October 2025. Not only has the forecast been refined, but the weather data processing has also been enhanced.
With this release, the development of Hubble AI reaches its provisional final state. Future updates related to this topic will be limited to bug fixes only.
Update for Home Assistant 2026.8.2
Solar Forecast ML for Home Assistant 2026.7.x -> 2026.8.x
The holiday build
The holiday build
Several issues have been fixed that were related to error reports from the forum as well as reported bugs. There is also a small surprise.
- FixesUTC bug in WFAI
- UTC bug in STATS
- Promotion-Gate TzInfo bug
- Several minor issues and edge cases
- Stability and resource optimization
Promotion Gate Fix V44.0.4
This update clears up several older open issues and improves especially the Options menu, zero-feed-in, and the Promotion Gate.
Fuel my late-night ideas with a coffee? I'd really appreciate it — keep this project running!
Options menu in SFML cleaned up
- The Options menu has been cleaned up and adapted to the current functional scope of the code. Outdated or now ineffective settings have been removed.
- In addition, the notifications have been correctly reconnected to the associated events. This concerns, among other things, forecast updates, training messages, and unexpected weather deviations.
- When a battery storage system is activated, a suitable solar-to-battery power sensor must now also be selected. This way, incomplete configurations are already detected when saving.
Important note on forecast notifications
- The Coordinator calculates an updated forecast by default once per hour. This calculation is important for internal processing and learning, but does not overwrite an already locked morning forecast.
- Please only activate the notification for forecast updates if you want to observe or check these regular Coordinator runs. Otherwise, every scheduled update can generate a new message, which can lead to confusion. 😉
Zero feed-in and battery storage
The detection of zero feed-in, inverter throttling, and fully charged battery storage systems has been revised.
Affected hours are now more reliably excluded from learning and from clean model evaluation.
This is intended to prevent technically throttled production from being incorrectly learned as actual generation potential.
AI selection removed
The manual selection of the AI model as well as the previous option to enable or disable individual AI components have been removed.
The current AI stack decides autonomously which model can be used depending on the data situation, maturity level, and quality. A manual selection would by now be more misleading than helpful.
Home Assistant app and Nabu Casa
The STATS web interface can now be used again via the Home Assistant Companion App and a Nabu Casa connection.
Login is performed via the existing Home Assistant session or the authentication of the Companion App.
Promotion Gate, Bootstrap, and database schema – ongoing construction site
I have fundamentally reviewed the Promotion Gate once more and corrected several errors.
New installations and existing databases now reliably receive the required tables and schema extensions again. The evaluation of a new model candidate is no longer dependent on certain ensemble rows. Valid comparison evidence can now also be collected during the Bootstrap phase. Restarts and multiple consecutive test days are correctly taken into account. Incomplete or unsuitable data can no longer accidentally lead to a model release.
Important note on “Pending Candidate”
Pending Candidate 1 does not mean that the counter has stopped!! A candidate remains in the “Pending” status until enough valid and comparable data from the planned test cycles is available. At least seven independent and fully evaluable days are required for a possible release. A more detailed explanation can also be found in the help section on the SFML website (www.solarforecastml.com). Simply search for “Pending Candidate”.
Database optimized
- The storage of the extensive Shadow and Promotion data has been optimized so that the database does not grow unnecessarily.
- The existing evidence is retained. The optimization is lossless and additionally checks the integrity of the stored data.
🚚 A small design error is intentionally left in place
For the heat pump, a yellow truck is still displayed. I find the error funny and have therefore deliberately not removed it. 😉
Minor Bug-Fixes
V44.0.2 fixes some reported bugs regarding the scheme validation after deleting sfml DB and some smaller fixes regarding the rain-sensor form external weather stations.
Also included are some improvements for ARM based systems.
pls visit bug-tracker for more information.
Summer-Update and Bug-Fixes
Release Notes – V44 (SFML + STATS + EAI)
New Website for Solar Forecast ML
Before presenting the technical changes and fixes in V44, a note about something that has been intensively worked on over the past weeks:
The new website for Solar Forecast ML
🌐 solarforecastml.com
The goal was to create a central place where SFML, STATS, EAI, and the other components are explained in a clear and coherent way — not as a pure marketing site, but as a practical resource for installation, sensors, features, known issues, and recurring questions.
The site includes, among other things:
- Overview of the entire local SFML ecosystem
- Detailed feature overview for SFML, STATS, EAI, and complementary components
- Searchable catalog of provided and required sensors
- Logically structured installation guide
- Concrete setup example for heat pumps
- Searchable help section with frequently asked questions and original log terms
- Public bug tracker with affected and fixed versions
- Overview of previous updates and release notes
SFML STATS V44
New STATS Design
With V44, the modern STATS interface has been extensively revised.
A key focus was the energy flow: On larger screens, the previous display sometimes looked like an inserted image with unnecessary colored empty space on the sides. Aspect ratio and size limits have been adjusted. The display now makes much better use of the available space and feels more like an integral part of the dashboard.
Further improvements:
- Optimized display on desktop and mobile devices
- No more unnecessary side empty spaces
- No horizontal page overflow
- Clean support for light and dark themes
- Continued full separation between Classic and Modern interfaces
New Navigation and Help
- The STATS navigation now includes a dedicated link to the official website
- Help leads to solarforecastml.com (installation notes, sensor information, known issues, and further explanations)
- Dedicated navigation entry for purchasing a license
- English translation completed
Security & Runtime
For V44, runtime paths have been reviewed and secured:
- Server-side premium check instead of a purely visual frontend lock
- Clear separation between demo and live data
- Protection against unwanted tab takeover and referrer leakage
- Classic interface remains unchanged
Solar Forecast ML V44.0.0
Unnecessary error messages and blocking additional steps have been corrected.
Improvements & Fixes:
-
Weather learning values are saved more reliably
During the daily closing process, many individual write operations could hit the database at the same time. As a result, individual weather learning values occasionally timed out. The values are now collected and saved in a short, combined operation. If saving still fails or the task is aborted, the previous valid state is retained. -
Missing learning data is no longer shown as an error
Especially on new installations, there are not always enough LSTM or Ridge data available for learning the panel groups. This normal situation was previously misleadingly displayed as a partially failed daily closing. V44 now treats it as a regularly skipped learning step. The remaining tasks of the daily closing continue to run fully. -
EAI and SFML no longer interfere with each other during daily closing
SFML and EAI previously started several background tasks simultaneously at 23:30. As a result, EAI could occasionally not retrieve the required astronomy data from SFML in time. -
Misleading additional output
NoneType: Noneremoved. -
The morning routine continues even without ensemble data
Daily Briefing: V44 now safely skips this optional evaluation and uses the successfully calculated physics forecast.
Enjoy V44!
Update V42.0.8 – AI FINAL
Fuel my late-night ideas with a coffee? I'd really appreciate it — keep this project running!
Release Notes:
This update marks the provisional completion of the modified AI, provision gates, eod, drift-detection, shadow detection, and database optimizations. It is the last update in this area for the time being.
-
In addition, the Bootstrap has been further optimized -> checks tables and errors on HA boot
-
The daily counter correction feature has been extended to allow identification and targeted correction of outliers. GitHub Issue #176 has now been fully resolved. The Promotion Gate is stable and counts correctly.
Community Update & New Features
V42.0.6 – Community Update & New Features
Fuel my late-night ideas with a coffee? I'd really appreciate it — keep this project running!
Bootstrap / Table Check on Startup:
Some users reported that after deleting the SFML database, the bootstrap failed on certain systems and tables were not created or repaired correctly.
The issue has been identified and fixed.
SFML now checks at Home Assistant startup (as Single Source of Truth) whether all required tables exist and are intact.
This check is necessary because the database can become corrupted due to crashes, container crashes (Proxmox/VM), power outages, blocking, HA errors, hardware issues, hard resets, etc.
Diagnostic Sensors Showing Nonsense Values:
With the introduction of the Promotion Gate for the best training model, the data source of some diagnostic sensors changed.
I simply forgot to reconnect them – sorry!
This has now been fixed.
New Feature: Correct Values (Premium only):
For a long time I have been looking for a 100 % Home Assistant-compliant way to allow corrections – without ever touching or manipulating the original Home Assistant database or the SFML database.
Such a solution is now integrated.
Please note: This is a first beta version and is only available for Premium users.
Currently correctable:
- Grid import
- Grid export
- PV yield
- Price per kWh (for fixed tariffs)
Not correctable (these values depend on each other):
- House consumption (calculated from multiple energy flows)
- Solar → House, Solar → Battery, Grid → House, Grid → Battery
- Battery charge and battery discharge
- Self-consumption and self-sufficiency
- Costs, savings and feed-in revenue
- Efficiencies
- Peak power and time
- Forecast, weather and ML values
Correcting any of these dependent values individually could create unrealistic results (e.g. more house consumption than available energy or impossible efficiency values).
Weather Fusion AI (EAI Edition)
The warning about a function that will be deprecated from August 2027 has been removed.
If you have any questions or notice further issues, just let me know.
Disclaimer:
SFML and its components are a private development and independent of the forum owner Simon42.
Home Assistant 2026.8x and Fixes
V42.0.4 – Bug Fixes - based on findings from users (GitHub + Simon42 Forum)
Fuel my late-night ideas with a coffee? I'd really appreciate it — keep this project running!
Here are the most important changes:
Home Assistant 2026.8.x ready!
Astronomy Data & Startup Issues
- The error “SFML astronomy database is unavailable or invalid” / “database is locked” has been fixed.
The integration now accesses the astronomy data cleanly and in a controlled way. - Short delays when accessing the database no longer cause the morning forecast to abort.
- The misleading message “refresh was coalesced” no longer appears.
- Normal database activities during startup are no longer falsely reported as errors.
- When reloading or unloading the integration, no delayed background tasks keep running.
- Database timing control is more robust and now also works with Home Assistant 2026.8.x.
AI Model Management
- The first AI model can now be activated more reliably as soon as enough comparison data is available.
- Selection of the best model candidates has been improved:
– Candidates with already collected shadow evidence are still preferred.
– If no candidate has useful evidence, the qualitatively best model is chosen (instead of simply the oldest one). - Previously deferred model candidates can now be re-evaluated in a controlled way without rewriting the immutable model history.
Shading Detection
- Complete group data is no longer incorrectly discarded as “incomplete”.
- Under rain and heavy cloud cover, reduced production is no longer so quickly classified as “local shading” (trees, buildings, etc.) – especially when no local irradiance or lux sensor is available.
- The diagnosis now more clearly distinguishes between:
– general loss compared to an ideal clear sky and
– actual local shading.
MPPT Detection
- Battery limitations, zero-export situations, unexpected cloud cover, etc. are no longer shown as “MPPT throttling” by default.
Only hours that were actually classified as MPPT throttling now appear as such.
Diagnostic Attributes
- The displayed values (feature count, training data, last training time, model status, current shading, etc.) are now always taken from the current runtime and database state and no longer from a possibly outdated cache.
If you have any questions or notice further issues, just let me know.
Credits:
- Greennothing for the excellent and thorough SQL review
- Joachim-xo for testing the UI
- Everyone who actively contributes and supports in the forum!
Disclaimer:
SFML and its components are a private development and independent of the forum owner Simon42.