Home Battery Simulation for Home Assistant (Marketplace integration)

Installs: 905 sharing analytics
GitHub stars: 231
Connection: Works locally
Upkeep: Updated in the last 6 months
Version: v2.9.0, October 7, 2026
Category: Energy, Solar and batteries
Kind: Marketplace integration
Needs: Needs the Marketplace (HACS on 2026.10 and older)
Domain: battery_sim
Source: github.com/hif2k1/battery_sim
Issues: Report an issue

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

Screenshots From the README of hif2k1/battery_sim.

About

Home Battery Simulation models how much energy a home battery would save, based on a home's import and export energy meters. The simulated battery charges while energy is being exported and discharges while energy is being imported, and the state of charge and total energy saved are published as sensors. Each battery can be defined with its size, charge and discharge rates, efficiency values or curves, rated cycles, end-of-life capacity and a minimum selectable state of charge. Fixed tariffs or tariff sensors can be attached to the meters, and an average energy value sensor estimates the monetary value of the usable energy stored. Actions can set the battery charge, the cycle count and the stored energy value, and can return the efficiency at a given power level. It runs locally and is set up in the UI, and the README notes that a real battery may behave differently from the simulation.

Automatic summary of the README and code of hif2k1/battery_sim. 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.

Select battery

Battery model

Custom Battery

Unique name
Battery size in kWh
Maximum discharge rate in kW
Maximum charging rate in kW
Discharge efficiency or curve (e.g. 0.95 or 0:0.9, 5:0.95)
Charge efficiency or curve (e.g. 0.95 or 0:0.9, 5:0.95)
Rated battery cycles
Capacity at end of life (0 to 1)
Update frequency in seconds
Solar energy sensor
Nominal inverter power in kW
Minimum user-selectable SOC (0 to 1)

Add Import Meter To Battery

Energy meter sensor

Also asked when at the add export meter to battery step.

Add Fixed Tariff Details

Fixed tariff value (if applicable)

Add Tariff Sensor Details

Sensor that shows current tariff (if applicable)

After setup

Battery size in kWh
Maximum discharge rate in kW
Maximum charging rate in kW
Discharge efficiency or curve (e.g. 0.95 or 0:0.9, 5:0.95)
Charge efficiency or curve (e.g. 0.95 or 0:0.9, 5:0.95)
Rated battery cycles
Capacity at end of life (0 to 1)
Update frequency in seconds
Solar energy sensor
Nominal inverter power in kW
Minimum user-selectable SOC (0 to 1)
Energy meter sensor
Energy meter sensor
Meter sensor
Meter sensor
Fixed tariff value
Sensor that shows current tariff
Configuration

Texts from the code of hif2k1/battery_sim.

Actions

Set Battery ChargeSet the battery charge state for a specific simulated batteryFields: Target Battery Device, Charge State
Set Battery CyclesSet the simulated battery cycles for a specific battery deviceFields: Target Battery Device, Battery Cycles
Get EfficiencyReturn the configured charge or discharge efficiency for a specific simulated battery at a given power level.Fields: Target Battery Device, Efficiency Type, Power Level
Set Stored Energy ValueSet the current total monetary value assigned to the energy stored in a specific simulated batteryFields: Target Battery Device, Stored Energy Value

From the README

Allows you to model how much energy you would save with a home battery if you currently export energy to the grid e.g. from solar panels. Requires an energy monitor that can measure import and export energy. Whenever you are exporting energy your simulated battery will charge up and whenever you are importing it will discharge. The battery state of charge and the total energy saved are published as sensors.
Please note this is a simulation and a real battery may behave differently and not all batteries will support all the features available in this simulation.

From the README of hif2k1/battery_sim, MIT License. Shortened.