Local GREE HVAC controller packaged as a Home Assistant add-on, with Web UI, HTTP/WebSocket API, built-in Swagger API documentation, UDP discovery/control, amd64 and aarch64 support, ingress, and database backup from /data/gree-controller.db.

Version 0.15.20 adds the Visual Flow heating-curve block with graphical X/Y points, selectable temperature sources, linear interpolation and dynamic setpoint binding for thermostats, GREE targets and Home Assistant service actions.

For VLAN deployments, configure VLAN interfaces on the Home Assistant OS host. The add-on uses host_network: true; with multiple directly attached subnets, gree_interface may remain empty. Run broadcast discovery separately for each VLAN/subnet.

Full documentation: DOCS.md.

The controller exposes /api/* and /ws. Interactive API documentation is available at /api-docs, with the OpenAPI 3.1 document at /api-docs/openapi.json. The same paths work through Home Assistant ingress; direct access on port 8787 follows the configured app_token rules.

The same Git repository also contains the optional custom_components/gree_controller integration. It is distributed with the repository but is not installed automatically with the add-on.

Repository: https://git.linuxiarz.pl/gru/gree-controller-ha-addon/