advantage-air

What it is and what it does

Advantage Air is an async Python client for controlling Advantage Air's MyAir and e-zone smart HVAC systems. It wraps the HTTP API to let you query system state and update air conditioning units, zones, lights, and other connected devices. The library is built on aiohttp for non-blocking I/O, making it suitable for integration into async applications.

The package provides a simple object model: you instantiate a client with the system's IP and port, call async_get() to fetch current state, then use methods like async_update_ac(), async_update_zone(), async_update_state(), and async_update_value() to send changes back to the system. All operations are async and can be run concurrently.

Use it for:

• Integrate Advantage Air HVAC systems into home automation frameworks for remote temperature and zone control.
• Build a custom dashboard or backend that queries and controls MyAir or e-zone systems over the local network.
• Automate zone temperature adjustments based on external triggers by polling and updating zones programmatically.
• Monitor and log air conditioning system state and performance metrics for analysis or alerting.
• Coordinate multi-zone climate control across a building by managing multiple AC units and zones in parallel.

Worth the install?

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

Async Python wrapper for Advantage Air's MyAir and e-zone API, enabling control of air conditioning systems, zones, lights, and other connected devices over HTTP.

Yes, if you own an Advantage Air MyAir or e-zone system and need async Python control—the API is straightforward and the dependency footprint is minimal. No, if you require active maintenance; the package has been abandoned since 2023-04-10 with no updates. Suitable for stable, self-contained integrations; risky for long-term production systems without a maintenance plan.

Install

advantage-air on PyPI

pip install advantage-air

uv add advantage-air

poetry add advantage-air

Installing advantage-air

Before you install

Low install friction with a single async dependency (aiohttp). However, the package is abandoned—last commit was 2023-04-10 with no updates since. Use only if the Advantage Air API has remained stable and you can maintain the code yourself if needed.

License in practice

MIT license (permissive) allows commercial and private use with minimal restrictions, making it safe to adopt from a licensing perspective.

Quickstart

import asyncio
import aiohttp
from advantage_air import advantage_air

async def main():
    async with aiohttp.ClientSession() as session:
        aa = advantage_air("192.168.1.24", port=2025, session=session, retry=5)
        data = await aa.async_get()
        await aa.aircon.async_update_ac("ac1", {"state": "on"})

asyncio.run(main())

Requires an Advantage Air MyAir or e-zone system accessible at a known IP address and port; aiohttp ClientSession must be provided.

Verify before relying

• Whether the Advantage Air API has remained stable since April 2023 and whether breaking changes have occurred.
• Current compatibility with modern aiohttp versions and Python 3.10+.
• Whether community forks or alternative maintained packages exist for this hardware.

Package facts

Evidence: advantage_air-0.4.4-py3-none-any.whl

Tags

More Internet packages