Skip to content
PXLJAKEPublic

About

Energy management for Home Assistant: peak shaving, PV surplus routing and price-based optimisation for dynamic tariffs, with an Apple-style dashboard and Bubble Card support.

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

189 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

SunCore

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.

SunCore "Now" view: live energy flow between solar, grid, battery and house

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.

Why another EMS?

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.

Principles

  • 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.

Documentation

Installing

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").

Licence

Apache-2.0. See LICENSE and NOTICE.

About

Energy management for Home Assistant: peak shaving, PV surplus routing and price-based optimisation for dynamic tariffs, with an Apple-style dashboard and Bubble Card support.

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages