Python Qube Heat Pump Client

Asyncio client for Qube heat pumps via Modbus TCP.

Installation

pip install python-qube-heatpump

Usage

import asyncio
from python_qube_heatpump import QubeClient

async def main():
    client = QubeClient("192.168.1.100", port=502, unit_id=1)
    await client.connect()

    state = await client.read_state()
    print(f"Outside temp: {state.temp_outside}°C")
    print(f"Supply temp: {state.temp_supply}°C")
    print(f"DHW temp: {state.temp_dhw}°C")

    await client.disconnect()

asyncio.run(main())

Features

  • Async Modbus TCP client using pymodbus
  • Entity definitions for sensors, binary sensors, and switches
  • FLOAT32 decoding with big endian (ABCD) byte order
  • Type-safe dataclasses for entity definitions

Entity Definitions

The library provides pre-defined entity definitions for all Qube Modbus registers:

from python_qube_heatpump.entities import SENSORS, BINARY_SENSORS, SWITCHES

# Access entity definitions by key
temp_supply = SENSORS["temp_supply"]
print(f"Address: {temp_supply.address}, Unit: {temp_supply.unit}")

Vendor Documentation

The official Modbus register documentation from HR-Energy is available at:

Related Projects

  • qube_heatpump - Home Assistant HACS integration using this library

License

MIT License

Project links

Data verified by PyPI on Aug 5, 2026
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Latest release

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for MattieGit from gravatar.com MattieGit

Credits

Author: MattieGit

GitHub Statistics

Data verified by PyPI on Aug 5, 2026
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License

MIT License

Requires

Python >=3.12

Provides Extra

test

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

python_qube_heatpump-1.13.0.tar.gz (96.3 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

python_qube_heatpump-1.13.0-py3-none-any.whl (19.9 kB view details)

Uploaded Python 3

File details

Details for the file python_qube_heatpump-1.13.0.tar.gz.

File metadata

  • Download URL: python_qube_heatpump-1.13.0.tar.gz
  • Upload date:
  • Size: 96.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for python_qube_heatpump-1.13.0.tar.gz
Algorithm Hash digest
SHA256 4999961ea89d27ba09d70045dfbbc49e1b918f6b54b63fe938c85a8e01b995f0
MD5 493a3be10e1bbe14883689d6e1a21733
BLAKE2b-256 492a36ff6650cfc5974dfcad4961b34a1f95d4f251da3bd817fc5a97c3c7483a

See more details on using hashes here.

Provenance

The following attestation bundles were made for python_qube_heatpump-1.13.0.tar.gz:

Publisher: python-publish.yml on MattieGit/python-qube-heatpump

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file python_qube_heatpump-1.13.0-py3-none-any.whl.

File metadata

File hashes

Hashes for python_qube_heatpump-1.13.0-py3-none-any.whl
Algorithm Hash digest
SHA256 62861a269bdffa01af6275af81f046a568a2a5503fa51ad74580a3064bd4c713
MD5 ffeb623471ab0b9696025cdeed97e9b9
BLAKE2b-256 89c9fbee713d9721cda3eb7ecdfb60346a1eaa965217ac8cbe886ca4223b3a68

See more details on using hashes here.

Provenance

The following attestation bundles were made for python_qube_heatpump-1.13.0-py3-none-any.whl:

Publisher: python-publish.yml on MattieGit/python-qube-heatpump

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

This release

1.13.0 This release

2 files

1.12.0

2 files

1.11.2

2 files

1.11.1

2 files

1.11.0

2 files

1.10.0

2 files

1.9.0

2 files

1.8.0

2 files

1.7.0

2 files

1.6.3

2 files

1.6.2

2 files

1.6.1

2 files

1.6.0

2 files

1.5.4

2 files

1.5.3

2 files

1.5.2

2 files

1.5.1

2 files

1.5.0

2 files

1.4.9

2 files

1.4.8

2 files

1.4.7

2 files

1.4.6

2 files

1.4.5

2 files

1.4.4

2 files

1.4.3

2 files

1.4.2

2 files

1.4.1

2 files

1.4.0

2 files

1.3.1

2 files

1.3.0

2 files

1.2.3

2 files

1.2.2

2 files

1.2.1

2 files

1.2.0

2 files

1.0.1

2 files

1.0.0

2 files

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page