---
id: airtouch4pyapi
version: "1.0.8"
license: unclear
license_treatment: permissive
maintenance: aging
---

# airtouch4pyapi — An api allowing control of AC state (temperature, on/off, mode) of an Airtouch 4 controller locally over TCP

License: permissive · Maintenance: aging · Downloads: 74.2K/mo

## 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 above — 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

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

- License: not declared (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: aging
- Downloads: 74.2K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

airtouch 4 python api, ac control tcp local, airtouch 5 python, air conditioning control python, hvac tcp control, airtouch group zone control, hvac-control, home-automation, tcp-client

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