sigenergy-cloud
Async Python client for the Sigenergy Cloud app API.
This package is a minimal async wrapper around the private Sigenergy Cloud app API. It is built for Home Assistant style integrations that need to read and control Sigenergy stations, batteries, and DC chargers.
Install
python -m pip install sigenergy-cloud
Example
from sigenergy_cloud import SigenergyCloudClient
client = SigenergyCloudClient("user@example.com", "password", region="eu")
await client.connect()
flow = await client.energy_flow()
mode = await client.current_operational_mode()
chargers = client.dc_sns
# Temporarily override the active strategy without leaving Sigen AI mode.
await client.set_instant_manual_control("0", duration_minutes=120) # Charging
await client.disable_instant_manual_control()
await client.close()
Shape
- Use
SigenergyCloudClientfor cloud calls. - Call
connect()once before reading data or changing settings. - The client keeps the station ID and charger serial numbers after connecting.
- Simple settings use small typed value objects.
- Vendor response payloads are returned as dictionaries where the API shape is still being mapped.
Instant Manual Control
The Sigenergy app exposes Instant Manual Control through the misspelled private
path device/energy-profile/instant/manunal. The app labels the modes as:
| Mode | Label |
|---|---|
0 |
Charging |
1 |
Discharging |
2 |
Hold Battery |
3 |
Self-Consumption |
Use set_instant_manual_control() for a 30-120 minute temporary override, and
disable_instant_manual_control() to hand control back to the active strategy.
Grid and power limits
The app's Grid Settings page maps to these calls. Owner values may only be lowered below the installer ceiling; the cloud reports both so callers can show the effective limit and the headroom.
| App setting | Read | Write | Installer ceiling key |
|---|---|---|---|
| Grid Export Power Limit | grid_export_limit() |
set_grid_export_limit(kw) |
maxLimitationInstaller |
| Grid Import Power Limit | grid_import_limit() |
set_grid_import_limit(kw) |
maxLimitationInstaller |
| Max Grid Connection Current (A) | grid_connection_limit() |
set_grid_connection_limit(a) |
installerSetLimitation |
| Battery Power Limit | battery_power_limit() |
set_battery_power_limit(...) |
– |
| PV power limit | solar_power_limit() |
set_solar_power_limit(kw) |
– |
| Backup Reserve | backup_reserve() |
set_backup_reserve(percent) |
– |
UNLIMITED_POWER_KW (4294967.295) is Sigenergy's "no limit" sentinel; use
is_unlimited_power(value) when displaying values. gateway_info() returns the
Sigen Gateway's grid-side per-phase voltage/current readings.
Regions
| Region | Base URL |
|---|---|
eu |
https://api-eu.sigencloud.com/ |
cn |
https://api-cn.sigencloud.com/ |
apac |
https://api-apac.sigencloud.com/ |
us |
https://api-us.sigencloud.com/ |
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file sigenergy_cloud-0.1.7.tar.gz.
File metadata
- Download URL: sigenergy_cloud-0.1.7.tar.gz
- Upload date:
- Size: 25.2 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
ac297abcf6341dbbb88c3d5b5ed4dec0cf62b5474e86445d8e00459088477193
|
|
| MD5 |
7f196d3766ddb6523952a06427d3d606
|
|
| BLAKE2b-256 |
a406a28c84de0f4e343ecdc704175656b6d5036ea2249dafd9fe1395f530416b
|
Provenance
The following attestation bundles were made for sigenergy_cloud-0.1.7.tar.gz:
Publisher:
python-publish.yml on solidfox/sigenergy-cloud
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
sigenergy_cloud-0.1.7.tar.gz -
Subject digest:
ac297abcf6341dbbb88c3d5b5ed4dec0cf62b5474e86445d8e00459088477193 - Sigstore transparency entry: 2785701736
- Sigstore integration time:
-
Permalink:
solidfox/sigenergy-cloud@99c744aa4b07f53836e7b2d76c1165701e4d52c1 -
Branch / Tag:
refs/tags/v0.1.7 - Owner: https://github.com/solidfox
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
python-publish.yml@99c744aa4b07f53836e7b2d76c1165701e4d52c1 -
Trigger Event:
release
-
Statement type:
File details
Details for the file sigenergy_cloud-0.1.7-py3-none-any.whl.
File metadata
- Download URL: sigenergy_cloud-0.1.7-py3-none-any.whl
- Upload date:
- Size: 20.2 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
2b0e267940ba9a7a0ec6276b15d661093748c0a6dd9b91780caf4333e35a2760
|
|
| MD5 |
ffe718166d6ec104b053e0f28fc206ec
|
|
| BLAKE2b-256 |
67823edb4a46f838a28332317b68e1e580b840bed8794b6c224822b0a0005dd1
|
Provenance
The following attestation bundles were made for sigenergy_cloud-0.1.7-py3-none-any.whl:
Publisher:
python-publish.yml on solidfox/sigenergy-cloud
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
sigenergy_cloud-0.1.7-py3-none-any.whl -
Subject digest:
2b0e267940ba9a7a0ec6276b15d661093748c0a6dd9b91780caf4333e35a2760 - Sigstore transparency entry: 2785701747
- Sigstore integration time:
-
Permalink:
solidfox/sigenergy-cloud@99c744aa4b07f53836e7b2d76c1165701e4d52c1 -
Branch / Tag:
refs/tags/v0.1.7 - Owner: https://github.com/solidfox
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
python-publish.yml@99c744aa4b07f53836e7b2d76c1165701e4d52c1 -
Trigger Event:
release
-
Statement type:
