python-stiebel-eltron
Python API for interacting with the STIEBEL ELTRON ISG web gateway via modbus for controlling integral ventilation units and heat pumps.
This module is based on the STIEBEL ELTRON modbus user manual, but is not official, developed, supported or endorsed by Stiebel Eltron GmbH & Co. KG. For questions and other inquiries, use the issue tracker in this repo please.
Requirements
You need to have Python installed.
- STIEBEL ELTRON Internet-Service Gateway ISG WEB with enabled modbus module
- You can call the STIEBEL ELTRON support, if your ISG does not have the modbus module enabled. They upgraded mine for free.
- STIEBEL ELTRON heatpumpt (compatible). Successfully used devices:
- LWZ504e
- LWZ304
- Network connection to the ISG WEB
Installation
The package is available in the Python Package Index.
Base install:
$ pip install pystiebeleltron
Install with the optional tmodbus backend used in the example below:
$ pip install "pystiebeleltron[tmodbus]"
Example usage of the module
The examples/ directory contains runnable examples for WPM and LWZ heat pumps. They use the optional tmodbus backend, so install pystiebeleltron[tmodbus] first.
The API takes a ModbusUnit. You own the connection: build it, hand a unit to the API, and close it when done. Building it performs no I/O — the first read establishes the link, and a link that drops later is re-established on the next request, over the same unit handle. Each register block is a component exposed on the API, and values are read as typed attributes (None when the register is unavailable).
Pass the IP address of the ISG gateway to the selected example:
./examples/wpm-example.py 192.168.1.10
./examples/lwz-example.py 192.168.1.10
The WPM example also demonstrates writing and restoring the DHW comfort temperature. The LWZ example reads room and outside temperatures and the current operating mode.
License
python-stiebel-eltron is licensed under MIT, for more details check LICENSE.
Release files for pystiebeleltron 0.9.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| pystiebeleltron-0.9.1.tar.gz | 19.1 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| pystiebeleltron-0.9.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 42.6 kB
Release files / pystiebeleltron-0.9.1.tar.gz
| Download URL | pystiebeleltron-0.9.1.tar.gz |
|---|---|
| Size | 19.1 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
565dfa495eb03e9d5d0260bb979ccbb19f520b9ec1bff87d40ac2e9219ccf3ba
|
|
BLAKE2b-256 checksum How to use checksums |
abbe1e80fbccb1ef9ba846000f6482a20cacb0aea2e9a7b8327a7706a8c29dce
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 9, 2026.
Transparency logRelease files / pystiebeleltron-0.9.1-py3-none-any.whl
| Download URL | pystiebeleltron-0.9.1-py3-none-any.whl |
|---|---|
| Size | 23.5 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
5de2654f326bfc33b2e695aa6b31769b5cb9d3bbb9d8f1932ea4242ad8e9d76b
|
|
BLAKE2b-256 checksum How to use checksums |
c0c6e299fa2b0d38ad81a2cec730fed3e6c6fd2c172d0d717e9c9cb056276f78
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 9, 2026.
Transparency log
