Helios Forecast

A solar forecast that learns your roof.

A self-learning production forecast that runs entirely on your own Home Assistant. It starts from the physics, then corrects itself with what your panels really do, and feeds the official Energy dashboard, the Helios card, and a clean set of sensors.

Open Helios Forecast in your Home Assistant via HACS Star on GitHub
The same sky, your actual roof

Watch it learn.

A cloud service predicts a generic panel at your coordinates. Helios starts there too, then bends the day with what your own home recorded. Flip the toggle: the gap is everything a cloud model can't see.

0 1.5 3 4.5 6 kW 06h 09h 12h 15h 18h 21h
  • Generic physics model
  • Learned from your data
  • What your history corrected
  • Uncertainty (P10-P90)
Corrected by what your panels actually did on days like this. Every dip the physics can't see, your own history already knows.
  • 34.2 kWh Expected today
  • 5.48 kW Peak power
  • 18.3 kWh Still to come
  • 84 % Reliability
How it works

From the physics to your panels.

  1. 1

    It starts with the sky

    Keyless Open-Meteo gives the hourly weather at your location: global, direct and diffuse irradiance, the plane-of-array irradiance for each of your orientations, plus cloud cover, temperature, wind and snow. The very data the Helios card reads, and your location is only ever an approximate point.

  2. 2

    A real physical model, not a black box

    From that weather, Helios computes the sun's position (checked against NOAA's reference to about 0.3 degrees), transposes the irradiance onto each tilted array, applies a cell-temperature derate, a snow-cover factor, and clips at your inverter limit. A multi-orientation install is summed by each array's share of your kWp.

  3. 3

    Then it learns from your roof

    This is where a cloud service can't follow. Helios keeps a rolling 60-day history of what your panels actually produced. For the hour being forecast it finds past hours with a similar sun position, cloud cover and temperature, and reads the spread of what you truly made then. The median becomes a site-calibrated prediction; the 10th and 90th percentiles become a free uncertainty band.

  4. 4

    And it tells you how much to trust it

    A reliability score blends how mature the learning is, how close recent predictions landed to reality, and how predictable today's sky is, then decays across the 7-day horizon the way weather-model skill really does. A trend value shows whether today now looks better or worse than it did at 06:00.

All of it runs on your own Home Assistant. Nothing about your production leaves your instance; the only thing that goes out is an approximate location, to fetch the weather from Open-Meteo.

Every entity it gives you

A clean, recorder-friendly surface.

39 entities per panel line, useful on their own in automations and history graphs, with or without the card. The values are the example install charted above, around noon on a mostly clear day.

Live now

Entity Value Unit What it is
Power now 4 820 W Instant predicted AC output right now.
Power now (low) 4 210 W P10 floor of the analog uncertainty band.
Power now (high) 5 260 W P90 ceiling of that band.
Power next hour 5 090 W Predicted average power for the hour ahead.
Entity Value Unit What it is
Energy this hour 4.70 kWh Predicted production this hour.
Energy next hour 5.02 kWh Predicted production next hour.
Energy today remaining 18.34 kWh Still expected between now and midnight.

The 7-day horizon

EnergyPeak powerPeak time
Today34.2 kWh5 480 W12:40
Day 231.8 kWh5 310 W12:10
Day 312.4 kWh2 240 W13:20
Day 428.9 kWh5 020 W12:35
Day 533.1 kWh5 460 W12:45
Day 630.5 kWh5 180 W12:20
Day 79.7 kWh1 890 W13:05

Three sensors, Energy day 1…7, Peak power day 1…7 and Peak time day 1…7, across the seven-day horizon: 21 entities.

The weather it saw

Entity Value Unit What it is
Cloud cover 12 % Archived Open-Meteo cloud cover.
Entity Value Unit What it is
Global irradiance 720 W/m² Shortwave radiation on the horizontal.
Direct irradiance 560 W/m² The beam component.
Diffuse irradiance 160 W/m² The scattered, sky component.
Entity Value Unit What it is
Temperature 26.4 °C Outdoor air, drives the cell-temperature derate.
Entity Value Unit What it is
Wind speed 11.2 km/h Wind at 10 m.
Entity Value Unit What it is
Snow depth 0.00 m Feeds the snow-cover factor.

Fetched from the remote Open-Meteo API, the only exchange that leaves your instance, and only as an approximate location: your exact coordinates never go out.

How much to trust it

Entity Value Unit What it is
Forecast reliability 84 % Confidence: maturity, recent skill, sky predictability.
Entity Value Unit What it is
Today forecast trend +1.6 kWh Change in today's total since 06:00.

For the card's memory

Entity Value Unit What it is
Predicted power 4 820 W Archive: powers the card's past predicted curve.
Entity Value Unit What it is
Predicted energy 4.70 kWh Archive: predicted production, hour by hour.
Local by design

The truth is already in your data.

There is no Helios server and no account. The physics comes from keyless Open-Meteo, the learning happens entirely inside your recorder history, and the result plugs straight into the official Energy dashboard as a native forecast provider. Add it once per panel line, and each roof orientation gets its own forecast, device and entities; two strings that only report one combined sensor go in a single entry and are summed by kWp share.

  • Your shading
  • Inverter clipping
  • Battery curtailment
  • On your instance
Why I built this

I still believe we can turn this around.

I'm Jérôme, 44, the developer behind Helios. After years across the whole stack, backend, frontend, 3D, games, embedded, I wanted to build something that actually matters to me.

A card won't save the planet, I know. But guilt and numbers nobody reads change no one: people change when they can finally see what's happening in their own home. That's the whole point of Helios, make energy visible, tangible, even beautiful, so acting on it stops feeling like a duty and starts feeling obvious.

Helios is free and open source, built by one person in the open.

ReikanYsora - Jérôme CREMOUX - 2026