python-izone

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 on this page — 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

python-izone on PyPI

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

Evidence: python_izone-1.3.10-py3-none-any.whl

Keywords: IoT, iZone

Tags

More Home Automation packages