<div align="center"> <img src="https://raw.githubusercontent.com/bolagnaise/PowerSync/main/logo.png" alt="PowerSync Logo" width="200"/>

PowerSync

Intelligent battery energy management for Home Assistant. Automatically optimize your battery system with dynamic electricity pricing to minimize costs and maximize savings.

<a href="https://testflight.apple.com/join/FhnUtSFy"><img src="https://img.shields.io/badge/iOS-TestFlight-blue?logo=apple&logoColor=white" alt="iOS TestFlight"></a> <a href="https://play.google.com/apps/testing/com.powersync.mobile"><img src="https://img.shields.io/badge/Android-Beta-3DDC84?logo=android&logoColor=white" alt="Android Beta"></a>

</div>

Disclaimer: This is an unofficial integration and is not affiliated with or endorsed by Tesla, Sigenergy, Sungrow, FoxESS, GoodWe, Amber Electric, Localvolts, Octopus Energy, or EPEX/ENTSO-E. Use at your own risk.

---

Supported Systems

Battery Systems

| 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 |

AC-Coupled Inverter Curtailment

Solar inverters that bypass the battery can be curtailed during negative feed-in prices:

| Inverter | Connection | Method | |----------|-----------|--------| | Fronius | SunSpec Modbus | WMaxLimPct power limiting | | Sungrow SG | Modbus TCP | Percentage power limit | | Sungrow SH | Modbus TCP | Export limit register | | Enphase | IQ Gateway REST API | DPEL/DER export limit | | FoxESS | Modbus TCP | Remote active power | | Huawei | Smart Dongle Modbus | Feed grid power limit | | GoodWe | Modbus TCP | Export limit register | | Zeversolar | HTTP API | Power limit percentage | | Solax | Modbus TCP or HA entity | Export control user limit (reg 0x42) | | Sigenergy | Modbus TCP | Grid export limit / DC curtailment |

Electricity Providers

| 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, Intelligent Go, Flux, Tracker). Reads from BottlecapDave's integration when installed | | EPEX Day-Ahead | EU (DE, AT, BE, NL, DK, SE) | Hourly day-ahead pricing with configurable surcharge & tax | | NZ TOU | New Zealand | Static TOU (Octopus NZ, Electric Kiwi, Contact Energy, Custom) |

---

Quick Start

1. Install via HACS (custom repository)
2. Add Integration — Settings > Devices & Services > Add Integration > "PowerSync"
3. Pick your electricity provider and enter API credentials if required
4. Connect your battery system and enter connection details
5. 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.

---

Installation

Prerequisites

• Home Assistant with HACS installed
• A supported battery system with network access
• Electricity provider API credentials (Amber requires a token; others are automatic)

Steps

Or manually:

1. Open HACS > three dots > Custom repositories
2. Add https://github.com/bolagnaise/PowerSync (Category: Integration)
3. Download PowerSync and restart Home Assistant
4. Settings > Devices & Services > Add Integration > "PowerSync"
5. Follow the guided setup for your provider and battery system

---

Features

| 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 |

---

Mobile App

Remote monitoring and control via iOS and Android.

iOS: Join TestFlight | Android: Join Beta (join testers group first)

Setup

1. Get your Home Assistant URL (local or Nabu Casa)
2. Create a Long-Lived Access Token in your HA profile
3. Enter URL + token in the app

Features

• 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

<p align="center"> <img src="docs/images/app-dashboard.png" alt="Dashboard" width="200"/> <img src="docs/images/app-dashboard-flow.png" alt="Power Flow" width="200"/> <img src="docs/images/app-optimization.png" alt="Smart Optimization" width="200"/> </p> <p align="center"> <img src="docs/images/app-optimization-schedule.png" alt="24-Hour Schedule" width="200"/> <img src="docs/images/app-optimization-plan.png" alt="Action Plan" width="200"/> <img src="docs/images/app-ev-charging.png" alt="EV Charging" width="200"/> </p> <p align="center"> <img src="docs/images/app-settings.png" alt="Settings" width="200"/> <img src="docs/images/app-provider.png" alt="Provider Settings" width="200"/> <img src="docs/images/app-provider-optimization.png" alt="Optimization Settings" width="200"/> </p>

---

Sponsors

<!-- sponsors --><a href="https://github.com/barry-heap"><img src="https:&#x2F;&#x2F;github.com&#x2F;barry-heap.png" width="60px" alt="User avatar: " /></a><a href="https://github.com/richardkeit"><img src="https:&#x2F;&#x2F;github.com&#x2F;richardkeit.png" width="60px" alt="User avatar: Richard Keit" /></a><a href="https://github.com/drsamking86-coder"><img src="https:&#x2F;&#x2F;github.com&#x2F;drsamking86-coder.png" width="60px" alt="User avatar: " /></a><a href="https://github.com/JoelyMoley"><img src="https:&#x2F;&#x2F;github.com&#x2F;JoelyMoley.png" width="60px" alt="User avatar: " /></a><a href="https://github.com/sgdodds"><img src="https:&#x2F;&#x2F;github.com&#x2F;sgdodds.png" width="60px" alt="User avatar: " /></a><a href="https://github.com/philsweetnam"><img src="https:&#x2F;&#x2F;github.com&#x2F;philsweetnam.png" width="60px" alt="User avatar: PhilS" /></a><a href="https://github.com/Barbars11"><img src="https:&#x2F;&#x2F;github.com&#x2F;Barbars11.png" width="60px" alt="User avatar: " /></a><a href="https://github.com/Teslemetry"><img src="https:&#x2F;&#x2F;github.com&#x2F;Teslemetry.png" width="60px" alt="User avatar: Teslemetry.com" /></a><a href="https://github.com/rdmarsh"><img src="https:&#x2F;&#x2F;github.com&#x2F;rdmarsh.png" width="60px" alt="User avatar: David Marsh" /></a><a href="https://github.com/zhenya-y"><img src="https:&#x2F;&#x2F;github.com&#x2F;zhenya-y.png" width="60px" alt="User avatar: " /></a><a href="https://github.com/tmorrison89"><img src="https:&#x2F;&#x2F;github.com&#x2F;tmorrison89.png" width="60px" alt="User avatar: " /></a><!-- sponsors -->

Support

• Discord: https://discord.gg/eaWDWxEWE3 — bug reports, feature requests, and support
• Wiki: https://github.com/bolagnaise/PowerSync/wiki

License

PolyForm Noncommercial 1.0.0 — free for personal and noncommercial use. Commercial use requires separate permission from the author.