Installation¶

Via HACS (recommended)¶

Click the button above (it opens HACS with this repository pre-filled), or add it manually in HACS → ⋮ → Custom repositories: https://github.com/alawresz/climate_orchestrator, category Integration.
Search for Climate Orchestrator in HACS, download it, then fully restart Home Assistant.
Settings → Devices & Services → Add Integration → "Climate Orchestrator".

Manual¶

Copy custom_components/climate_orchestrator/ into your Home Assistant configuration's custom_components/ directory:
```
<config>/custom_components/climate_orchestrator/
```
Fully restart Home Assistant (a new integration is only discovered on startup; "reload" is not enough). On first start HA installs scipy.
Settings → Devices & Services → Add Integration → "Climate Orchestrator", then select your TRVs, ACs, and (optionally) an outdoor sensor, a weather entity, and your own whole-home average temperature/humidity sensors — see First setup for a walkthrough of every field.

Changing the configuration later¶

You can change the selected devices — and every other setup field, including the advanced TRV name hints — later via the integration's Configure (options) dialog. Each field is explained in First setup.

Upgrading¶

Upgrade through HACS as usual (download the new version, then restart Home Assistant). To test prereleases, enable Show beta versions on the integration in HACS. All tunables and learned state (MPC models, adaptive values) persist across restarts, so an upgrade resumes where it left off.

Removal¶

Go to Settings → Devices & services → Climate Orchestrator, open the entry's menu (⋮) and choose Delete. The integration's persisted learned state (MPC models, adaptive values) is cleaned up automatically.
Remove the repository from HACS (or delete custom_components/climate_orchestrator/ for a manual install) and restart Home Assistant.
Your TRVs and ACs simply stop being orchestrated — they keep their last commanded state and return to manual control.

Next: First setup