HAEO for Home Assistant (Marketplace integration)

Installs: 109 sharing analytics
GitHub stars: 76
Connection: Works locally
Upkeep: Updated in the last 6 months
Version: v0.4.1, October 27, 2026
Category: Energy, Meters and monitoring
Kind: Marketplace integration
Needs: Needs the Marketplace (HACS on 2026.10 and older)
Domain: haeo
Source: github.com/hass-energy/haeo
Issues: Report an issue

Independent directory, made by the developer of Vulpo. Not affiliated with Home Assistant or the Open Home Foundation.

About

HAEO is a Home Assistant Energy Optimiser that plans battery, solar, grid and load flows using linear programming. It builds a model of the home energy system from configured elements such as batteries, electric vehicles, solar, loads, grid connections, connections, junctions and inverters, then minimizes total cost over a planning horizon using electricity prices and forecasts. Optimization reruns when input data changes, with a debounce window, and when the horizon advances. Results appear as sensors, numbers and switches, and an action can run an optimization or save a diagnostics file. Settings cover the planning horizon from 2 to 7 days, an option to relax impossible plans, and optional recording of forecast data. Repair notices flag problems such as disconnected components or a failed optimization, and it runs locally with setup in the UI.

Automatic summary of the README and code of hass-energy/haeo. Something wrong, or are you the maintainer and want your own text here? Get in touch

Supports

Works locally Talks to your devices on your own network. No vendor cloud in between.
From the Marketplace Installed through the Marketplace, formerly HACS.
Actively maintained Its author released or pushed a change in the last six months.

Provides

Switches
Sensors

Setting it up

Install it from the Marketplace and restart Home Assistant, then add it under Settings, Devices and services.

HAEO setup

Expose raw model elementsShows low-level model elements you connect manually. Leave off unless you are deliberately building the optimization model yourself.
Planning horizonA preset covering 2 to 7 days, or a sensor whose forecast times set the start and end of every period.
System name

HAEO settings

Expose raw model elementsShows low-level model elements you connect manually. Leave off unless you are deliberately building the optimization model yourself.
Debounce window (seconds)
Record forecast dataWhen enabled, forecast attributes are saved to the recorder database. This significantly increases database size but allows debugging historical forecasts. Disabled by default to reduce database load.
Relax impossible plansWhen the forecasts ask for more than your system can do, such as a load above what the grid and batteries can supply, plan with the fewest constraints relaxed instead of failing. A repair issue lists what was relaxed. Leave off to fail the optimization and list the constraints that conflict.
Planning horizonA preset covering 2 to 7 days, or a sensor whose forecast times set the start and end of every period.

After setup

Expose raw model elementsShows low-level model elements you connect manually. Leave off unless you are deliberately building the optimization model yourself.
Debounce window (seconds)
Record forecast dataWhen enabled, forecast attributes are saved to the recorder database. This significantly increases database size but allows debugging historical forecasts. Disabled by default to reduce database load.
Relax impossible plansWhen the forecasts ask for more than your system can do, such as a load above what the grid and batteries can supply, plan with the fewest constraints relaxed instead of failing. A repair issue lists what was relaxed. Leave off to fail the optimization and list the constraints that conflict.
Planning horizonA preset covering 2 to 7 days, or a sensor whose forecast times set the start and end of every period.

Texts from the code of hass-energy/haeo.

Entities

NumbersCapacity, Charge cost, Limit cost, Discharge cost, Discharge efficiency, Charge efficiency, Initial charge, Max charge, Max discharge power, Max charge power, Min charge, Salvage value, and 31 more
SensorsEnergy in flow shadow price, Energy out flow shadow price, Energy stored, Active power, Power balance shadow price, Charge power, Discharge power, SOC max shadow price, SOC min shadow price, State of charge, Available energy, Required energy, and 34 more
SwitchesRun window, Window start, Away, Plugged in, Trip start, Shedding, Auto optimize, Is sink, Is source, Enabled, Curtailment

Actions

OptimizeRuns an optimization for the given systemFields: System
Save diagnosticsSave a diagnostics file to the config directoryFields: System, Time

Troubleshooting

System healthAdds its status to Home Assistant's system information.
Repair noticesNotices it can show in Settings, Repairs:System has disconnected components, Connections bypass an element's own limits and prices, Elements refer to elements that do not exist, Price inputs report different currencies, Is now a junction, Optimization failed, No plan meets every constraint, A plan had to relax constraints it cannot meet, HAEO could not start

From the README

HAEO (Home Assistant Energy Optimizer) is a custom integration that optimizes your home's energy usage in real-time using linear programming. It helps you minimize energy costs by intelligently managing battery storage, solar generation, grid import/export, and loads based on electricity prices, forecasts, and system constraints.
Real-time Optimization: Continuously optimizes energy flow across all connected devices
Multi-device Support: Batteries, solar panels, grid connection, loads, and energy flows
Power Policies: Source→destination pricing so the optimizer values solar, grid, and battery flows differently (guide)
Price-based Optimization: Minimizes costs using real-time and forecast electricity prices
Solar Integration: Optimizes solar generation with curtailment support
Battery Management: Smart charging/discharging based on prices and SOC constraints
Flexible Configuration: Easy-to-use UI configuration via Home Assistant
HiGHS Solver: Fast, reliable linear programming via bundled highspy bindings
Rich Sensors: Power, energy, cost, and state of charge sensors for all devices

From the README of hass-energy/haeo, MIT License. Shortened.