This release is a pre-release and may not be stable for production use.
sigenergy2mqtt is a bridge between the Modbus interface of the Sigenergy energy system and the MQTT lightweight publish/subscribe messaging protocol.
In addition, sigenergy2mqtt has several optional features:
- It can auto-discover Sigenergy devices and their device IDs without having to specify the host IP address.
- It can publish the appropriate messages to allow Home Assistant to automatically discover the Sigenergy devices, simplifying Home Assistant configuration.
- Production and consumption data can automatically be uploaded to PVOutput.
- It can directly publish the Modbus data to an InfluxDB (v1/2) time series database for long-term storage and analysis.
Pre-requisites
- Sigenergy ESS or PV Inverter, with Modbus-TCP enabled by your installer or through the mySigen app
- MQTT broker such as Mosquitto, either standalone or installed as an app to Home Assistant
Installation
Follow the installation guides for supported environments:
Configuration
When parsing configuration options, sigenergy2mqtt looks at the configuration sources in the following order:
This means, for example, that the options specified in the configuration file can be overridden by environment variables and command line options.
The combined reference for CLI flags, environment variables, and YAML configuration keys can be found here.
1 Not applicable to the Home Assistant App
Screenshots
Dashboard
Diagnostics
MQTT Publish and Subscribe Topics
The topics that are published and subscribed to by sigenergy2mqtt can be found here.
Disclaimer
sigenergy2mqtt was developed for my own use, and as such has only been tested in my single-phase environment without AC or DC chargers, although I have developed a testing environment in software that emulates the chargers and three phase implementations. If you find a problem, please raise an issue.
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 sigenergy2mqtt-2026.8.30b1.tar.gz.
File metadata
- Download URL: sigenergy2mqtt-2026.8.30b1.tar.gz
- Upload date:
- Size: 538.4 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
a42291e96d2c01a4de3527cfa31f1975b8e32ac96625df235b055f0d3d167918
|
|
| MD5 |
a160bc73d274c17aa03912eaf1d4f5d2
|
|
| BLAKE2b-256 |
c7057273f69de9126c85c25fc351dd87cb6fc5f3b6f83f4ccb37d2e4dc8743a3
|
Provenance
The following attestation bundles were made for sigenergy2mqtt-2026.8.30b1.tar.gz:
Publisher:
publish-pypi.yml on seud0nym/sigenergy2mqtt
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
sigenergy2mqtt-2026.8.30b1.tar.gz -
Subject digest:
a42291e96d2c01a4de3527cfa31f1975b8e32ac96625df235b055f0d3d167918 - Sigstore transparency entry: 2648100147
- Sigstore integration time:
-
Permalink:
seud0nym/sigenergy2mqtt@f41ee7ec807c032d4b4fc5725cdf42950c8a5802 -
Branch / Tag:
refs/tags/2026.8.30b1 - Owner: https://github.com/seud0nym
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish-pypi.yml@f41ee7ec807c032d4b4fc5725cdf42950c8a5802 -
Trigger Event:
release
-
Statement type:
File details
Details for the file sigenergy2mqtt-2026.8.30b1-py3-none-any.whl.
File metadata
- Download URL: sigenergy2mqtt-2026.8.30b1-py3-none-any.whl
- Upload date:
- Size: 609.5 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 |
902fe69d0ae3a7c52f5f66b992e6b77aa8a515e41fbff5096df9c897ef92363c
|
|
| MD5 |
871e0004591bc01a2b26d170210c4773
|
|
| BLAKE2b-256 |
0b6537ea8308632ad0f2f8b82b3eaed22fd9c93429b0198a3405917f8190dfea
|
Provenance
The following attestation bundles were made for sigenergy2mqtt-2026.8.30b1-py3-none-any.whl:
Publisher:
publish-pypi.yml on seud0nym/sigenergy2mqtt
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
sigenergy2mqtt-2026.8.30b1-py3-none-any.whl -
Subject digest:
902fe69d0ae3a7c52f5f66b992e6b77aa8a515e41fbff5096df9c897ef92363c - Sigstore transparency entry: 2648100180
- Sigstore integration time:
-
Permalink:
seud0nym/sigenergy2mqtt@f41ee7ec807c032d4b4fc5725cdf42950c8a5802 -
Branch / Tag:
refs/tags/2026.8.30b1 - Owner: https://github.com/seud0nym
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish-pypi.yml@f41ee7ec807c032d4b4fc5725cdf42950c8a5802 -
Trigger Event:
release
-
Statement type:
