airtouch4pyapi

What it is and what it does

Airtouch4pyapi is a Python TCP client for controlling Airtouch 4 and 5 air conditioning systems locally over the network. It exposes async methods to manage AC units and zones—turning them on/off, setting target temperatures, adjusting cooling modes and fan speeds, and querying supported capabilities. The package is designed for direct local control without cloud dependencies, making it suitable for home automation integrations or standalone AC management scripts.

The library requires initialization with the controller's IP address and an optional version parameter (defaulting to Airtouch 4). After calling UpdateInfo() to load the device configuration, you can issue commands at the group level (zones) or AC unit level. The maintainer has tested it with their own Airtouch 4 hardware and notes that Airtouch 5 support is experimental but interface-compatible; the package carries a disclaimer that the author is not responsible for AC system issues.

Use it for:

• Home automation: integrate Airtouch AC control into Home Assistant or similar platforms via local TCP.
• Scheduled temperature management: write scripts to adjust AC settings based on time of day or occupancy.
• Multi-zone climate control: programmatically manage different zones or groups within a single Airtouch system.
• Testing and debugging: use the included demo.py to verify connectivity and functionality with your Airtouch controller.
• Custom monitoring: build dashboards or alerts based on AC state and supported capabilities.

Worth the install?

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

Controls Airtouch 4 and 5 air conditioning units locally over TCP, allowing you to set temperature, power state, cooling mode, and fan speed by group or AC unit.

Yes, if you own an Airtouch 4 or 5 controller and need local Python-based control. The package has low install friction, permissive licensing, and no known vulnerabilities. However, it is aging (last release January 2023) and Airtouch 5 support remains experimental—verify compatibility with your hardware before relying on it in production. Not relevant if you do not have an Airtouch system.

Install

airtouch4pyapi on PyPI

pip install airtouch4pyapi

uv add airtouch4pyapi

poetry add airtouch4pyapi

Installing airtouch4pyapi

Before you install

Low install friction with a single runtime dependency (numpy). Package is aging—last release was over a year ago, though the repository remains active with a recent commit in September 2025. Suitable for existing Airtouch 4 users; Airtouch 5 support is noted as experimental.

License in practice

MIT license (permissive) allows use, modification, and distribution with minimal restrictions, making it safe for personal or commercial projects.

Quickstart

pip install airtouch4pyapi

from airtouch4pyapi import AirTouch, AirTouchVersion

airTouch = AirTouch("192.168.1.19")
await airTouch.UpdateInfo()
await airTouch.SetGroupToTemperature(group_id, temperature)

Requires an Airtouch 4 or 5 controller on the local network; async/await context required for most operations.

Verify before relying

• Whether numpy is actually used at runtime or is a transitive dependency artifact.
• Current stability and compatibility with Airtouch 5 beyond the 'experimental' label from November 2022.
• Whether the package works with modern Python versions beyond 3.6 despite the classifier.

Package facts

Evidence: airtouch4pyapi-1.0.8-py3-none-any.whl

Tags

More Networking packages