Sigenergy

Home Assistant custom integration for Sigenergy Cloud.

The integration uses the published sigenergy-cloud Python package for Sigenergy Cloud API access and exposes Sigenergy station, battery, grid, PV, smart load, and DC charger controls in Home Assistant.

Features

• Config flow with Sigenergy Cloud username, password, and region selection.
• Optional cloud fetch modules for station settings, Sigen AI forecasts, and EVDC/V2X data, so unused API groups can be disabled from integration options.
• Energy flow sensors for PV, grid, load, battery, battery SOC, and EV charging.
• Battery SOC, grid import/export, peak shaving, and operational mode controls.
• Grid connection current limit ("Max Grid Connection Current" in the app, A) number and enable switch, plus diagnostic sensors for the installer-set ceilings of the grid export/import/connection limits, battery and solar power limits, and backup reserve. Owner limits are capped at the installer value.
• DC charger status, session, OCPP, alarm, charge-limit, V2X, and bidirectional controls when a Sigenergy DC charger is available on the account.

Installation

HACS

1. Use the button above to open this repository in HACS, or add it manually as a custom repository.
2. Select category Integration if adding it manually.
3. Download Sigenergy in HACS.
4. Restart Home Assistant.
5. Add the integration from Settings > Devices & services > Add integration.

Manual

Copy custom_components/sigenergy into your Home Assistant custom_components directory, restart Home Assistant, and add the integration from Settings > Devices & services.

Development

Install the development requirements and run the local checks:

python3 -m pip install -r requirements.txt
scripts/lint

The integration depends on the external sigenergy-cloud package pinned in custom_components/sigenergy/manifest.json. Release the library package first, then update the manifest pin when publishing integration changes that require a new library version.