---
id: aiosomecomfort
version: "0.0.38"
license: MIT
license_treatment: permissive
maintenance: active
---

# AIOSomecomfort — A client for Honeywell's US-based cloud devices

License: permissive · Maintenance: active · Downloads: 78.2K/mo

## What it is and what it does

AIOSomecomfort is an AsyncIO-based Python client for Honeywell's US cloud thermostat platform. It wraps the Honeywell API to let you query and control supported thermostats programmatically—reading current temperature and humidity, adjusting heating and cooling setpoints, changing fan and system modes, and managing hold schedules. The package is built on aiohttp for non-blocking network I/O, making it suitable for integration into async applications like home automation systems or monitoring daemons.

The package includes a command-line test tool demonstrating all major operations: login, device discovery, temperature queries, setpoint adjustments, and mode changes. It is actively maintained but still in beta status. The main constraint is that it only works with US-based Honeywell accounts and devices; EU models are explicitly unsupported.

Use it for:

- Integrate thermostat control into a home automation platform to read and adjust heating and cooling setpoints.
- Build a monitoring daemon that periodically polls thermostat temperature and humidity to log energy usage or trigger alerts.
- Automate seasonal setpoint changes or time-based hold schedules without manual Honeywell app interaction.
- Query multiple thermostats across a property to synchronize settings or detect equipment failures.
- Create a custom CLI or web dashboard for remote thermostat management without relying on Honeywell's official app.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

AsyncIO client for querying and controlling Honeywell US-model thermostats through their cloud API, supporting temperature setpoints, fan modes, system modes, and hold scheduling.

Yes, if you own a US-based Honeywell thermostat and need programmatic control. Low install friction, permissive license, active maintenance, and no known vulnerabilities make it a safe choice. The beta status suggests it works but may lack polish; verify it supports your specific thermostat model before committing to a production integration.

## Install

pip install aiosomecomfort
uv add aiosomecomfort
poetry add aiosomecomfort

## Installing AIOSomecomfort

Before you install: Low install friction with only two runtime dependencies (aiohttp and prettytable). Active maintenance with a recent release on 2026-07-09 and last commit on 2026-07-23, though the repository has modest activity.

License in practice: MIT license is permissive, allowing use in commercial and private projects with minimal restrictions; attribution is required but no copyleft obligations apply.

Quickstart:

pip install AIOSomecomfort

from aiosomecomfort import client
# Requires Honeywell account credentials and device ID
await client.login(username, password)
temp = await device.get_current_temperature()

Requires valid Honeywell US account credentials and a supported US-model thermostat; EU models are not supported.

Verify before relying:

- Whether the package supports modern Python versions or has specific version constraints not listed in requires_python.
- Whether authentication persists across sessions or requires re-login for each script run.
- Real-world reliability and response times when controlling multiple thermostats or frequent polling.
- Whether the package handles API rate limits or connection failures gracefully.
- Specific thermostat models and firmware versions confirmed to work with this client.

## Package facts

- License: MIT (permissive)
- Python support: unspecified
- Install friction: low
- Maintenance: active
- Downloads: 78.2K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

honeywell thermostat api client, asyncio thermostat control, honeywell cloud thermostat, smart thermostat python, hvac system control, temperature setpoint management, thermostat automation, home-automation, iot-device-control, asyncio

[View on SkillFed](https://skillfed.io/packages/aiosomecomfort) · [View on PyPI](https://pypi.org/project/aiosomecomfort/)