Skip to content

Repository files navigation

Sigenergy

Home Assistant custom integration for Sigenergy Cloud.

Open your Home Assistant instance and open this repository in HACS.

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

About

Home Assistant custom integration for Sigenergy Cloud

Topics

Resources

Contributing

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages