maxcube-api

What it is and what it does

maxcube-api is a Python library for communicating with eQ-3/ELV MAX! Cube thermostats via network protocol. It was originally built to support Home Assistant integration and exposes basic operations: querying cube metadata, listing connected thermostat devices, reading their modes and temperatures, and saving or restoring thermostat programs to JSON.

The package has no external runtime dependencies and requires Python 3.7 or later. It is dormant since its last release in May 2021, but the underlying repository remains minimally maintained. It is suitable for home automation scenarios where you already own MAX! hardware and need programmatic control, but should be considered stable rather than actively developed.

Use it for:

• Retrieve current room temperature and thermostat mode from MAX! devices for home automation dashboards.
• Back up and restore thermostat heating programs to JSON files for disaster recovery or device migration.
• Integrate MAX! Cube control into home automation platforms.
• Monitor multiple MAX! thermostats across a home network and log temperature data over time.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Provides a Python API to query and control eQ-3/ELV MAX! Cube thermostats over the network, retrieving device status, temperatures, and modes.

Yes, if you own MAX! Cube hardware and need programmatic control—low install friction, no dependencies, and no known vulnerabilities. No, if you are looking for active development or support; the package is dormant since 2021. Verify the unclear license before use in commercial projects.

Install

maxcube-api on PyPI

pip install maxcube-api

uv add maxcube-api

poetry add maxcube-api

Installing maxcube-api

Before you install

Low install friction with no runtime dependencies. Maintenance is dormant—last release was in May 2021, though the repository remains active with a recent commit in June 2024. Suitable for stable use cases but expect no active development.

License in practice

License treatment is unclear; the package metadata does not specify an SPDX identifier or standard license type. Verify the actual license text before using in proprietary or commercial projects.

Quickstart

from maxcube.cube import MaxCube

cube = MaxCube('192.168.0.20')
for device in cube.devices:
    print(device.name, device.actual_temperature)

Requires network access to a MAX! Cube device on the local network; no simulation or mock mode documented.

Verify before relying

• Whether the unclear license permits commercial or proprietary use without restrictions
• Compatibility with current MAX! Cube hardware versions and firmware releases

Package facts

Evidence: maxcube_api-0.4.3-py2.py3-none-any.whl

Tags

More Monitoring packages