---
id: nexia
version: "2.13.0"
license: Apache-2.0
license_treatment: permissive
maintenance: active
---

# nexia — Python library for connecting to nexia

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

## What it is and what it does

Nexia is an async Python client for Nexia-connected thermostats (Trane/American Standard models). It provides programmatic access to thermostat state, zone control, and RoomIQ sensor management via the Nexia Home API. The library uses aiohttp for async HTTP communication and orjson for efficient JSON parsing, making it suitable for integration into home automation systems or monitoring applications that need non-blocking I/O.

The package exposes thermostats and zones as objects with attributes like current temperature, humidity, fan mode, and operation mode, plus methods to refresh sensor data, manage hold modes, and configure which RoomIQ sensors contribute to zone averages. It is in pre-alpha development (version 2.13.0) and officially supports Python 3.10–3.14.

Use it for:

- Integrate Nexia thermostats into a home automation platform (e.g., Home Assistant) for remote temperature and humidity control.
- Monitor zone temperatures and sensor readings across multiple thermostats in a multi-zone HVAC system.
- Automate thermostat adjustments based on external events or schedules via async coroutines.
- Query and manage RoomIQ sensor participation in zone temperature averaging.
- Build a dashboard or API that exposes thermostat state and control to other applications.

## Worth the install?

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

Async Python library for controlling Nexia (Trane/American Standard) thermostats and their zones, including temperature, humidity, fan modes, and RoomIQ sensor management.

Yes, if you own a supported Nexia thermostat (XL950, XL1050, XL824) and need async Python control. Low install friction, active maintenance, no known vulnerabilities, and permissive licensing are all favorable. Pre-alpha status means the API may change; verify that your thermostat model and desired features are fully implemented before committing to production use.

## Install

pip install nexia
uv add nexia
poetry add nexia

## Installing nexia

Before you install: Low install friction with a pure-Python wheel and only three runtime dependencies (aiohttp, orjson, propcache). Actively maintained with a recent commit on 2026-08-10 and pre-alpha status indicating ongoing development.

License in practice: Licensed under Apache-2.0 (permissive), allowing commercial and private use with minimal restrictions.

Quickstart:

pip install nexia

import asyncio
from nexia import NexiaHome

async def main():
    home = NexiaHome(username, password)
    await home.update()
    for thermostat in home.thermostats:
        print(thermostat.current_temperature)

asyncio.run(main())

Requires Python 3.10 or later; asyncio event loop required for all operations.

Verify before relying:

- Whether XL950, XL1050, XL824 models are fully tested or represent aspirational support.
- Current state of Nexia API stability and whether breaking changes are expected during pre-alpha.
- Whether all thermostat attributes and services documented in the excerpt are fully implemented.

## Package facts

- License: Apache-2.0 (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 75.9K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

nexia thermostat control, trane american standard api, async hvac thermostat library, nexia home automation, thermostat zone management, roomiq sensor integration, nexia python client, hvac-control, async-io, home-automation

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