{"id":46773,"library":"vtherm-api","title":"vtherm-api","description":"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.","status":"active","version":"0.3.0","language":"python","source_language":"en","source_url":"https://github.com/jm-73/vtherm-api","tags":["home-assistant","thermostat","api"],"install":[{"cmd":"pip install vtherm-api","lang":"bash","label":"Install from PyPI"}],"dependencies":[],"imports":[{"note":"Correct module path uses underscore, not dot.","wrong":"from vtherm.api import VThermAPI","symbol":"VThermAPI","correct":"from vtherm_api import VThermAPI"}],"quickstart":{"code":"from vtherm_api import VThermAPI\n\napi = VThermAPI(base_url=\"http://localhost:8123\", token=os.environ.get('HASS_TOKEN', ''))\nprint(api.get_thermostats())","lang":"python","description":"Initialize VThermAPI with Home Assistant base URL and long-lived access token. Requires a running HA instance with the Versatile Thermostat integration installed."},"warnings":[{"fix":"Upgrade Python to 3.14+ before installing.","message":"Requires Python 3.14 or newer. Older Python versions will fail to install.","severity":"gotcha","affected_versions":"<=3.13"},{"fix":"Pin your integration version and test after updates.","message":"The library is tightly coupled to the Versatile Thermostat integration; API endpoints may change without notice between integration versions.","severity":"breaking","affected_versions":"all"}],"env_vars":null,"search_vec":"'0.3.0':17 '3.14':20 'api':3,6,33 'assist':14,31 'cadenc':22 'current':15 'home':13,30 'home-assist':29 'integr':11,27 'irregular':24 'provid':4 'python':19 'releas':21 'requir':18 'thermostat':10,32 'tie':25 'updat':28 'versatil':9 'version':16 'vtherm':2 'vtherm-api':1","created_at":"2026-06-07T13:01:34.129953+00:00","updated_at":"2026-06-07T13:01:34.129953+00:00","problems":{"verify_error":"× No solution found when resolving dependencies:\n  ╰─▶ Because the current Python version (3.12.13) does not satisfy\n      Python>=3.14 and all versions of vtherm-api depend on Python>=3.14, we\n      can conclude that all versions of vtherm-api cannot be used.\n      And because you require vtherm-ap"},"ecosystem":"pypi","meta_description":null,"install_score":null,"quickstart_score":null,"quickstart_tag":null,"pypi_latest":null,"cli_name":null,"cli_version":null,"type":"library","homepage":null,"github":null,"docs":null,"changelog":null,"pypi":null,"npm":null,"openapi_spec":null,"status_page":null,"smithery":null,"categories":["devops"],"base_url":null,"auth_type":null,"provenance":{"verified_status":"install_fail","verified_at":"2026-06-29","last_verified":"2026-06-29","next_check":"2026-07-06","install_tag":null}}