{"categories":[{"label":"Networking","url":"https://skillfed.io/packages/category/system-networking/2"}],"enrichment":{"capability":"Async Python library for discovering, connecting to, and controlling Gree-based mini-split air conditioning and heat pump systems over the network.","skillfed_tags":["hvac-control","async-io","device-discovery"],"use_cases":["Integrate Gree mini-split systems into Home Assistant or other home automation platforms for centralized climate control.","Build custom monitoring dashboards that query device state (temperature, mode, fan speed) over the network.","Automate HVAC scheduling by setting power, target temperature, and operating mode via async Python scripts.","Troubleshoot device connectivity issues using the built-in discovery and diagnostic tools.","Control multiple Gree units concurrently in a single application using async/await patterns."],"what_it_does":"greeclimate is a fully async Python library for controlling Gree-branded mini-split HVAC systems (air conditioners and heat pumps) that are also compatible with the Gree+ mobile app. It handles network discovery, device binding with encryption key negotiation, and state management for properties like power, temperature, fan speed, and operating mode. The library uses netifaces for network interface detection and pycryptodome for the two-layer encryption scheme that Gree devices employ.\n\nThe package is designed for home automation integrations and has been tested on Proklima and Trane mini-split units. It provides async methods for scanning the network, binding to discovered devices, querying current state, and pushing configuration changes. The binding process is described as finnicky\u2014devices only respond to binding requests immediately following a network scan, and re-binding may be necessary if the device key is lost.","worth_installing":"Yes, if you own a Gree-compatible mini-split system and need programmatic control. The package is actively maintained, has low install friction, and provides a clean async API. The main gotcha is that device binding is finnicky and requires immediate re-scan if the device key is lost\u2014test discovery and binding thoroughly before relying on it in production. GPLv3 licensing means any derivative work must remain open-source."},"id":"greeclimate","links":{"html":"https://skillfed.io/packages/greeclimate","md":"https://skillfed.io/packages/greeclimate.md","pypi":"https://pypi.org/project/greeclimate/"},"maintenance":{"status":"active"},"meta":{"latest_release":"2026-06-11","license_spdx":null,"license_treatment":"copyleft","name":"greeclimate","python_support":"supports_current","summary":"Discover, connect and control Gree based minisplit systems"},"popularity":{"monthly_downloads":79672,"position":14342,"tier":"top_15000"},"security":{"n_vulnerabilities":0},"version":"3.2.0"}