Intelligent battery energy management for Home Assistant. Automatically optimize your battery system with dynamic electricity pricing to minimize costs and maximize savings.
Disclaimer: This is an unofficial integration and is not affiliated with or endorsed by Tesla, Sigenergy, Sungrow, FoxESS, GoodWe, Amber Electric, Localvolts, or Octopus Energy. Use at your own risk.
| System | Connection | Control |
|---|---|---|
| Tesla Powerwall | Fleet API or Teslemetry | TOU tariff sync, force charge/discharge, export rules |
| FoxESS (H1, H3, H3-Pro, H3 Smart, KH + OEM rebrands) | Modbus TCP or RS485 | Work mode, force charge/discharge, backup reserve |
| Sigenergy | Cloud API + Modbus TCP | Tariff sync, DC solar curtailment |
| GoodWe (ET, EH, BT, BH, ES, EM, BP) | UDP or TCP (local) | Force charge/discharge, backup reserve, export limit |
| Sungrow SH-series | Modbus TCP | Force charge/discharge, rate limiting, export control, dual inverter |
| Provider | Country | Pricing |
|---|---|---|
| Amber Electric | Australia | Dynamic 5-min & 30-min (API token required) |
| Localvolts | Australia | Real-time 5-min wholesale pricing (API key + Partner ID) |
| Flow Power / AEMO | Australia | Wholesale pricing |
| Globird / AEMO VPP | Australia | Static + spike detection |
| Octopus Energy | UK | Dynamic 30-min (Agile, Go, Flux, Tracker) |
| NZ TOU | New Zealand | Static TOU (Octopus NZ, Electric Kiwi, Contact Energy, Custom) |
- Install via HACS (custom repository)
- Add Integration — Settings > Devices & Services > Add Integration > "PowerSync"
- Pick your electricity provider and enter API credentials if required
- Connect your battery system and enter connection details
- Done! Sensors appear automatically and a PowerSync dashboard is auto-created in your sidebar. Enable Smart Optimization for automated scheduling, or install the Mobile App for remote control.
- Home Assistant with HACS installed
- A supported battery system with network access
- Electricity provider API credentials (Amber requires a token; others are automatic)
Or manually:
- Open HACS > three dots > Custom repositories
- Add
https://github.com/bolagnaise/PowerSync(Category: Integration) - Download PowerSync and restart Home Assistant
- Settings > Devices & Services > Add Integration > "PowerSync"
- Follow the guided setup for your provider and battery system
| Feature | Description | Wiki |
|---|---|---|
| Battery System Setup | Tesla, FoxESS, Sigenergy, GoodWe, Sungrow connection guides | Setup Guide |
| Smart Optimization | Built-in LP optimizer calculates optimal charge/discharge schedule using prices, solar, and load | Details |
| EV Smart Charging | Coordinate EV charging with battery optimization — Solar, Cheapest, Deadline modes | Details |
| Advanced Features | AEMO spike detection, solar curtailment, spike protection, export boost, chip mode | Details |
| Sensors | Core power sensors, daily energy tracking, FoxESS Modbus sensors, optimizer status | Full List |
| Services | Force charge/discharge, TOU sync, backup reserve, inverter curtailment | Reference |
| Troubleshooting | Connection issues, debug logging, common fixes | Guide |
Remote monitoring and control via iOS and Android.
iOS: Join TestFlight | Android: Join Beta (join testers group first)
- Get your Home Assistant URL (local or Nabu Casa)
- Create a Long-Lived Access Token in your HA profile
- Enter URL + token in the app
- Dashboard — Live pricing, power flow, energy summary
- Smart Optimization — 24-hour battery schedule, action plan, cost tracking
- EV Charging — Smart scheduling, solar surplus, price-level charging
- Settings — Battery, EV, provider, and optimization configuration
- Discord: https://discord.gg/eaWDWxEWE3 — bug reports, feature requests, and support
- Wiki: https://github.com/bolagnaise/PowerSync/wiki
PolyForm Noncommercial 1.0.0 — free for personal and noncommercial use. Commercial use requires separate permission from the author.