Energy management for Home Assistant: forecasts, a cost-optimising planner and a real-time surplus controller in one app – explainable, safe by default, set up in minutes.
Status: pre-alpha, Phase 3 implemented (waiting for the maintainer's shadow-mode test on real hardware). The beta app has a guided setup assistant, a device template gallery (LG ThinQ air conditioner, generic switch, climate and adjustable load, water heaters, Tibber, Solcast), the live energy-flow view and a real-time surplus controller with a safety layer: priorities, hysteresis, minimum run times, no grid import caused by SunCore, respect for manual changes, an emergency stop, and a "Why?" and decision log for every decision. Everything starts in shadow mode and switches nothing until you set a device to automatic; the controller has never run against real hardware yet. Forecasts, planner and battery control follow in Phase 4. See Surplus control, the roadmap and status.
Screenshot from the built-in demo mode (simulated data).
SunCore runs as a Home Assistant app (formerly add-on) on Home Assistant OS. It reads your PV, battery, grid and consumer entities, forecasts production, load and prices, plans the next 24–48 h with a linear optimiser, and distributes real surplus every few seconds to air conditioners, heat pumps, water heaters, wallboxes and switchable loads – while a safety layer guarantees hard limits are never crossed.
| evcc | EMHASS | Predbat | SunCore | |
|---|---|---|---|---|
| Real-time surplus control | excellent (chargers, heaters, plugs) | – | – | yes, for all consumer types |
| Forward-looking optimisation | cloud optimiser, sponsor-gated, informational | strong LP, you wire it up | strong for supported inverters | built in, local, explainable |
| Setup | YAML + UI | JSON config + automations | HA entities + YAML | guided wizard, auto-detection, shadow mode |
| Explains decisions | partly | no | plan tables | every decision has a "why" |
| Licence | MIT (+ sponsor features) | MIT | personal use only | Apache-2.0 |
When to use what: keep evcc if you want best-in-class charge-point control – SunCore can use it as an actor. Use EMHASS if you like building your own automations around an LP. Use Predbat for GivEnergy & co. battery arbitrage on UK tariffs. SunCore aims at the household that wants all of it with a 15-minute setup, and it is honest about being young: see the roadmap.
- Productive in 15 minutes: entity auto-detection, live sign and unit checks, shadow mode first.
- Explainable: every plan interval and every switch has a reason in plain language.
- Safe: shadow → assisted → automatic per device; fail-safe states; watchdogs; invariants that are property-tested.
- Simple for beginners, deep for experts: good defaults, an expert switch that exposes every parameter.
- Local and private: no cloud requirement, no telemetry.
- Community-extensible: devices, tariffs, forecasts, regions as YAML templates with schema validation.
- Brief – the product and engineering specification
- Architecture · ADRs · Research notes
- Quick start · Schnellstart
- Surplus control · Überschusssteuerung
- Contribute a device template · Compatibility list
- Roadmap · Status
- Contributing · Security · Code of Conduct
Once the first beta is released, add https://github.com/pxljake/suncore
as an app repository in Home Assistant (Settings → Apps → App store →
menu → Repositories) and install SunCore (beta). The beta guides you through
the setup, shows the live energy flow and runs the surplus controller in shadow
mode; there are no forecasts or planner yet.
Start with the quick start
(Deutsch). Menu names differ between Home
Assistant versions (older ones say "Add-ons" and "Add-on store").
