Skip to main content

python-izone

Python library for the iZone air conditioning system.

Used by the Home Assistant iZone integration.

Install

pip install python-izone

Overview

The main entry points are Controller and Zone for device control, and DiscoveryService for UDP discovery on the local network.

Synchronous property reads return cached device data and do not raise ConnectionError. Async command and refresh methods perform HTTP I/O and raise ConnectionError when the device cannot be reached. They raise ControllerCommandError when the device responds but rejects the request ({ERROR} body or HTTP 4xx). Setters raise InvalidValueError before any I/O when a value is out of range, off its step, or not supported by the system or zone. It subclasses both ValueError and AttributeError.

Dependencies

Requires aiohttp>=3.14.1. Home Assistant pins aiohttp==3.14.1; that version includes the HTTP POST coalescing fix (aiohttp#10991) needed for iZone controllers that read the request in a single operation.

Protocol documentation

The iZone Ethernet interface is documented in AC-DOC-1401-11_iZoneEthernetInterface.pdf.

Troubleshooting / issue reports

If Home Assistant can load the iZone integration, prefer Download diagnostics from the integration page.

A bridge is only reported as found once it answers over HTTP. When one replies to discovery but fails that check, the library says why: discover_all() lists it in the result's unverified, and discover_by_host() / discover_by_uid() raise EndpointVerifyError with a VerifyFailure reason (no HTTP reply, unreadable reply, a different UID, or a host name that didn't resolve). Failures during background discovery are logged at debug level on the pizone.discovery logger.

When that is not possible (or you need a live HTTP/UDP survey of the bridge), run the stdlib probe from a machine on the same LAN:

curl -fsSL -o izone_v1_probe.py \
  https://raw.githubusercontent.com/Swamp-Ig/pizone/main/scripts/izone_v1_probe.py
python3 izone_v1_probe.py <bridge-ip> --with-content-type > izone-v1-probe.log

Attach izone-v1-probe.log to the GitHub issue. The CLI host (IP or hostname) and IPv4/IPv6 literals in the log are redacted to **REDACTED** by default (including UDP IP_… payloads); use --show-ips only for local debugging. Stop Home Assistant (or other listeners on UDP 7005) first if the UDP listen step fails to bind.

Development

  1. Install uv.
  2. uv sync --all-extras --group dev
  3. ./scripts/check — lint, type-check, test, and build (same as CI)
  4. ./scripts/coverage — test coverage report (advisory; not part of the CI gate)

Individual commands:

  • uv run pytest tests/
  • uv run ruff check pizone tests
  • uv run ruff format pizone tests
  • uv run mypy pizone
  • uv build

To run integration tests against a controller on your network:

uv run pytest -m hardware -o addopts=

They bind UDP port 7005, so stop Home Assistant or anything else using iZone discovery on the same machine first.

Metadata

Release files for python-izone 2.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for python-izone 2.1.0
File Size Uploaded Provenance Actions
python_izone-2.1.0.tar.gz 709.3 kB With provenance Details for python_izone-2.1.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for python-izone 2.1.0
File Interpreter ABI Platform Actions
python_izone-2.1.0-py3-none-any.whl Python 3 none any Details for python_izone-2.1.0-py3-none-any.whl

Total release size: 764.3 kB

Release files / python_izone-2.1.0.tar.gz

Download URL python_izone-2.1.0.tar.gz
Size 709.3 kB
Tags Source
SHA-256 checksum
How to use checksums
291a088faf9e9fc7dd1a61ee9abf1275281eccb0a73d4f98babc52b7f706082e
BLAKE2b-256 checksum
How to use checksums
e8a14e8cb7665e91b7890d09ca6f84cbfb492fb0cde258bc10b0db04b67ab3cb
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 11, 2026.

Transparency log

Release files / python_izone-2.1.0-py3-none-any.whl

Download URL python_izone-2.1.0-py3-none-any.whl
Size 55.0 kB
Tags Python 3
SHA-256 checksum
How to use checksums
1b446623b57e693887f297d88b1ca81beaf2745fc97363dc765156abef1cad5c
BLAKE2b-256 checksum
How to use checksums
cd40a8c760a5b3cb050055c377ca7febe0c837eaf23f568063b18c1855f9dfeb
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 11, 2026.

Transparency log

Security for python-izone 2.1.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for python_izone-2.1.0.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 11, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

2.1.0 This release

2 release files Full provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page