vtherm-api

library0.3.0pypypiunverified

Provides the API for the Versatile Thermostat integration in Home Assistant. Current version 0.3.0, requires Python 3.14+; release cadence is irregular tied to integration updates.

devops

pip install vtherm-api

INSTALL

IMPORT

SIG · VTHERM-API

vtherm-api

devopspythonv0.3.0

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

VThermAPI

✓ from vtherm_api import VThermAPI

✗ from vtherm.api import VThermAPI

Correct module path uses underscore, not dot.

Initialize VThermAPI with Home Assistant base URL and long-lived access token. Requires a running HA instance with the Versatile Thermostat integration installed.

from vtherm_api import VThermAPI api = VThermAPI(base_url="http://localhost:8123", token=os.environ.get('HASS_TOKEN', '')) print(api.get_thermostats())

Debug

Known issues

gotchaRequires Python 3.14 or newer. Older Python versions will fail to install.

fix

Upgrade Python to 3.14+ before installing.

affects: <=3.13

breakingThe library is tightly coupled to the Versatile Thermostat integration; API endpoints may change without notice between integration versions.

fix

Pin your integration version and test after updates.

affects: all

Upgrade

Version history

0.3.0latest on PyPI · released Apr 22, 2026

Audit

Dependencies

No dependency data recorded yet.

Agent activity

12 hits · last 30 days

node

Resources

No resource links recorded.