pyaehw4a1

What it is and what it does

pyaehw4a1 is a lightweight Python client for communicating with Hisense AEH-W4A1 wifi modules installed in multi-split air conditioning systems. It implements the XM serial protocol to discover units on the local network, query their status, and send control commands (power, mode, temperature, fan speed, turbo, energy-save, display, sleep, and airflow direction). The package is designed primarily as a foundation for Home Assistant integration and includes both a Python module for programmatic use and command-line tools for direct interaction.

The author explicitly notes this is an early, unsupported implementation written as a first Python project with no warranty. The package has been abandoned since mid-2020 and receives no maintenance, making it suitable only for users with specific Hisense hardware who can tolerate potential compatibility issues with modern Python environments.

Use it for:

• Integrate Hisense multi-split AC units into Home Assistant or other home automation systems via local network control.
• Query current AC status (temperature, mode, fan speed) from a Python script without cloud dependencies.
• Automate AC commands (power, temperature adjustment, mode switching) based on local triggers or schedules.
• Discover available Hisense AEH-W4A1 modules on an intranet without manual IP configuration.

Worth the install?

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

Provides a Python interface to control Hisense AEH-W4A1 wifi-enabled air conditioning units over the local network using the XM serial protocol.

Yes, but with caution: install only if you own a Hisense AEH-W4A1 module and accept the risks of an abandoned package. The low install friction and permissive license are favorable, but the lack of maintenance since 2020 means no security updates, no Python compatibility assurance, and no protocol updates for newer AC firmware. Suitable for hobbyists and Home Assistant users willing to troubleshoot or patch the code themselves; unsuitable for production or mission-critical automation.

Install

pyaehw4a1 on PyPI

pip install pyaehw4a1

uv add pyaehw4a1

poetry add pyaehw4a1

Installing pyaehw4a1

Before you install

Low install friction with no runtime dependencies. However, the package is abandoned—last updated 2020-07-05 with no commits since. Maintenance status is inactive, so security patches or compatibility fixes for newer Python versions are unlikely.

License in practice

Licensed under Apache 2.0 (permissive), allowing use in most projects without significant legal constraints.

Quickstart

pip install pyaehw4a1

python -m pyaehw4a1 discovery
python -m pyaehw4a1 AC --host IP_ADDRESS
python -m pyaehw4a1 AC --host IP_ADDRESS --command on

Requires a Hisense AEH-W4A1 wifi module on the local network; no Python version constraint is specified in the package metadata.

Verify before relying

• Whether the package works with current Python versions given its abandoned status and last release in 2020.
• Compatibility with Home Assistant or other home automation platforms beyond the author's initial intent.
• Whether the XM protocol implementation remains accurate for current Hisense AC firmware versions.

Package facts

Evidence: pyaehw4a1-0.3.9-py3-none-any.whl

Tags

More Home Automation packages