---
id: python-izone
version: "1.3.10"
license: GPL-3.0-or-later
license_treatment: copyleft
maintenance: active
---

# python-izone — A python interface to the iZone airconditioner controller

License: copyleft · Maintenance: active · Downloads: 79.7K/mo

## What it is and what it does

python-izone is a Python library that communicates with iZone air conditioning controllers over HTTP and UDP on a local network. It provides async methods to send commands and refresh device state, plus a UDP discovery service to locate controllers. Synchronous property reads return cached data without network I/O, while async methods perform actual device communication and raise ConnectionError or ControllerCommandError on failure.

The library is designed for home automation integrations and is actively used by Home Assistant's iZone integration. It depends on aiohttp for HTTP I/O and ifaddr for network discovery, and requires Python 3.14 or later. The main entry points are Controller and Zone for device control, and DiscoveryService for finding controllers on the network.

Use it for:

- Integrate iZone air conditioning into Home Assistant or other home automation systems.
- Build a custom dashboard or CLI tool to monitor and control iZone zones.
- Discover and enumerate iZone controllers on a local network for inventory or diagnostics.
- Automate temperature adjustments across multiple zones based on time or sensor input.
- Develop a local network app that reads cached zone state without constant device polling.

## Worth the install?

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

Python library for controlling iZone air conditioning systems over HTTP, with UDP discovery and async command support.

Yes, if you own an iZone air conditioning system and need to integrate it with Python-based home automation or custom tooling. The package is actively maintained, has no known vulnerabilities, and low install friction. The GPL-3.0-or-later copyleft license is a consideration only if you plan to distribute derivative code. Requires Python 3.14 or later and aiohttp>=3.14.1.

## Install

pip install python-izone
uv add python-izone
poetry add python-izone

## Installing python-izone

Before you install: Low install friction; pure Python wheel with two runtime dependencies (aiohttp and ifaddr). Actively maintained with a release 3 days ago.

License in practice: GPL-3.0-or-later copyleft license; any derivative work or distribution must also be open-source under compatible terms.

Quickstart:

pip install python-izone

import asyncio
from python_izone import Controller

async def main():
    controller = Controller('device-ip')
    await controller.refresh()
    print(controller.zones)

asyncio.run(main())

Requires Python 3.14 or later; aiohttp>=3.14.1 must be installed. Device must be reachable on the local network.

Verify before relying:

- Whether aiohttp>=3.14.1 is reliably available in target environments (the description notes a specific POST coalescing fix requirement).
- Whether the package works with iZone controllers other than those tested by the maintainer.
- Practical network requirements and latency tolerances for reliable device communication.

## Package facts

- License: GPL-3.0-or-later (copyleft)
- Python support: capped_below_current
- Install friction: low
- Maintenance: active
- Downloads: 79.7K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

izone air conditioning control, home automation hvac, async hvac device library, izone controller python, local network ac system, air conditioning device api, udp device discovery, home-automation, hvac-control, local-network

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