--- title: "Home Battery Simulation" description: "Home Battery Simulation is a Marketplace integration for Home Assistant. It has 905 installs sharing analytics, works locally and was last updated October 7, 2026." canonical: "https://vulpo.app/integrations/marketplace/hif2k1-battery-sim" url: "https://vulpo.app/integrations/marketplace/hif2k1-battery-sim.md" last-updated: "2026-10-22" version: "1.4" --- # Home Battery Simulation > Home Battery Simulation is a Marketplace integration for Home Assistant. It has 905 installs sharing analytics, works locally and was last updated October 7, 2026. 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](https://vulpo.app/contact) [Open in My Home Assistant](https://my.home-assistant.io/redirect/hacs_repository/?owner=hif2k1&repository=battery_sim&category=integration) On Home Assistant 2026.11 or newer? [Open it in the Marketplace](https://my.home-assistant.io/redirect/marketplace_repository/?owner=hif2k1&repository=battery_sim&category=integration) ## 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. ## 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](https://github.com/hif2k1/battery_sim). ## Actions - **Set Battery Charge**: Set the battery charge state for a specific simulated battery Fields: Target Battery Device, Charge State - **Set Battery Cycles**: Set the simulated battery cycles for a specific battery device Fields: Target Battery Device, Battery Cycles - **Get Efficiency**: Return 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 Value**: Set the current total monetary value assigned to the energy stored in a specific simulated battery Fields: 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](https://github.com/hif2k1/battery_sim#readme), [MIT License](https://spdx.org/licenses/MIT.html). Shortened. ## At a glance - Kind: Marketplace integration - Category: [Energy](https://vulpo.app/integrations/category/energy.md), Solar and batteries - Number: 905 installs sharing analytics; 231 GitHub stars - Connection: Works locally - Upkeep: Updated in the last 6 months - Needs: Needs the Marketplace (HACS on 2026.10 and older) - Latest version: v2.9.0, last updated October 7, 2026 - Domain: `battery_sim` - Source: - Issues: - Screenshot: https://vulpo.app/integrations-img/72c263d3b6afc3f7.webp (from hif2k1/battery\_sim's README) - Screenshot: https://vulpo.app/integrations-img/5201e57270f4544a.webp (from hif2k1/battery\_sim's README) In Vulpo: Quick Toggle card, Button card, Select card, Chart card, Apple Watch, Control Center Independent directory, made by the developer of Vulpo. Not affiliated with Home Assistant or the Open Home Foundation. [About these numbers](https://vulpo.app/integrations/about) Last updated 2026-10-22. Source: https://vulpo.app/integrations/marketplace/hif2k1-battery-sim --- - HTML version of this page: https://vulpo.app/integrations/marketplace/hif2k1-battery-sim - Site index for agents: https://vulpo.app/llms.txt - Everything in one document: https://vulpo.app/llms-full.txt - All pages: https://vulpo.app/sitemap.xml