This is a personal fork of springfall2008/batpred with the following additions on top of upstream (currently based on upstream v9.3.0):
The built-in web UI (port 5052) gains a /dash_entities page and a redesigned power flow diagram.
This fork publishes its own GitHub releases (versioned v712.xx) via a release workflow that derives the tag from THIS_VERSION in apps/predbat/predbat.py on push to main. Predbat's built-in updater points at this fork, so installations tracking this repository self-update from these releases.
- Database history now returns correct results for entities with no state change inside the query window
- cspell dictionary ordering fixed to match the pre-commit hook
CLAUDE.md, AGENTS.md, CODEX.md and GEMINI.md provide guidance for AI coding agents working in this repository, including fork-specific constraints (kernel ABI revision rules, release process).
Everything below is the upstream README.
Home battery prediction and automatic charging for Home Assistant supporting multiple inverters, including GivEnergy, Solis, Huawei, SolarEdge, SigEnergy, FoxESS, Sofar, Tesla Powerwall and many more.
Also known by some as Batpred or Batman!
If you want to buy me a beer, then please use Paypal or GitHub sponsor
- Use my referral code for Octopus Energy: https://share.octopus.energy/jolly-eel-176
- Use my referral code for Axle Energy (UK): https://vpp.axle.energy/landing/grid?ref=R-VWIICRSA
If you find Home Assistant and Predbat too difficult to set up yourself, there is now PredBat Cloud, a paid version of Predbat hosted in the cloud. Please note that while I have given permission for PredBat Cloud to operate under license, PredBat will remain open source for personal use.
You can find the latest Predbat documentation at https://springfall2008.github.io/batpred/ and how-to videos on my YouTube channel.
The documentation covers how Predbat works and how to get it installed and configured, video tutorials and FAQs to help you get going. It also explains how you can contribute to the project.
For support, please raise a GitHub ticket or use the Facebook Group: Predbat
Some inverters have their own groups also, e.g.:
Please see License
Copyright (c) Trefor Southwell 2025-2026 - All rights reserved
This software may be used at no cost for personal use only.
No warranty is given, either expressed or implied.