miraie-ac-in 1.0.8

MirAIe-AC API for Python — actively maintained fork of miraie-ac

MirAIe AC API Client (miraie-ac-in)

A Python API client wrapper for controlling Panasonic MirAIe-enabled Air Conditioners. This library handles MQTT message parsing, connection loops, and telemetry status decoding.

This repository is a feature fork of rkzofficial/miraie-ac to provide updates for newer firmware versions, expand capacity control options, and improve connection stability.

[!IMPORTANT] This project is designed exclusively for Panasonic Air Conditioners that use the MirAIe application. It is not compatible with Panasonic ACs that use the global Comfort Cloud application.

---

Enhancements in This Fork

• Firmware 3.02+ Room Temperature Fix: Panasonic AC units running firmware 3.02+ report ambient room temperature in a packed decimal format. This fork introduces version-aware decoding to display this value correctly, while retaining traditional decoding for older firmware.
• Converti 8-in-1 Support: Expands compressor capacity control options by mapping the 60% and 50% steps, enabling full 8-in-1 capacity features on supported models.
• MQTT & Resource Lifecycle Cleanup: Adds an explicit close() method to cleanly cancel and await active MQTT tasks and terminate the underlying HTTP client session, preventing resource leaks.
• Telemetry Parsing: Adds status parsing for Nanoe™ air purifiers (acng), Filter Clean alerts (acfc), Wi-Fi RSSI signal strength (rssi), and last control source (cnt).
• Input Validation: Upgraded user credential validation with improved regex supporting subdomains and hyphenated domains.

---

Installation

Install the package via pip:

pip install miraie-ac-in

---

Quick Start

import asyncio
from miraie_ac import MirAIeHub, MirAIeBroker

async def main():
    broker = MirAIeBroker()
    hub = MirAIeHub()

    # Initialize the hub (phone number format: +91XXXXXXXXXX)
    await hub.init("[phone]", "your_password", broker)
    
    # List discovered devices
    print("Discovered Devices:", hub.home.devices)
    
    # Wait for the MQTT connection to establish
    while not hasattr(broker, "client") or getattr(broker, "client") is None:
        await asyncio.sleep(1)

    # Example: Turn off the first device
    if hub.home.devices:
        device = hub.home.devices[0]
        await device.turn_off()
        
    await hub.close()

asyncio.run(main())

---

Credits & License

Upstream Authors & Contributors

• Originally authored and developed by @rkzofficial.
• Features contributed by upstream community developers: @deCodeIt, @gutpull, and @ankitduseja.

Fork Authors & Contributors

• Fork enhancements (firmware 3.02+ temperature fix, Converti 8-in-1, and MQTT resource leak resolutions) developed by @selvakk2k with assistance from Claude (Anthropic) and Gemini/Antigravity (Google DeepMind).

Licensed under the MIT License. See the LICENSE file for the original license text.