https://github.com/btoddb/room-climate-controller

A Home Assistant Integration that coordinates/controls climate devices in a room.
https://github.com/btoddb/room-climate-controller

air-conditioning hacs-integration hass heating-control home-assistant home-assistant-integration homeassistant hvac-control

Last synced: 4 days ago
JSON representation

A Home Assistant Integration that coordinates/controls climate devices in a room.

• Host: GitHub
• URL: https://github.com/btoddb/room-climate-controller
• Owner: btoddb
• License: mit
• Created: 2026-06-04T23:22:44.000Z (11 days ago)
• Default Branch: main
• Last Pushed: 2026-06-08T22:10:26.000Z (7 days ago)
• Last Synced: 2026-06-09T03:21:08.662Z (7 days ago)
• Topics: air-conditioning, hacs-integration, hass, heating-control, home-assistant, home-assistant-integration, homeassistant, hvac-control
• Language: Python
• Homepage:
• Size: 354 KB
• Stars: 0
• Watchers: 0
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# Room Climate Controller

A Home Assistant **custom integration** (HACS-installable) for per-room climate

control and scheduled daily climate **profiles**, with a companion Lovelace card

it ships and auto-registers.

- Per-room reactive control of A/C / heater / fan devices (cool / heat / fan-only /

  off, plus fan-speed tiers) driven by a pure, unit-tested decision engine.

- Daily **profiles**: named, scheduled per-room presets (use toggles, fan override,

  target temps) created and edited from the card.

- Native entities, HA areas, abstraction sensors (room temp/humidity/power + a

  hub-level Outdoor Temperature), and plotly energy/history graphs.

See [custom_components/room_climate_controller/README.md](custom_components/room_climate_controller/README.md)

for full details, and [requirements/](requirements/) for the design requirements.

## Install

- **HACS:** add this repo as a custom repository (category: Integration), install,

  restart HA, then **Settings → Devices & Services → Add Integration → "Room

  Climate Controller"** and **Add room** per room.

- **Manual:** copy `custom_components/room_climate_controller/` into your HA

  `config/custom_components/`, restart, then add the integration as above.

A ready sample dashboard is in

[`custom_components/room_climate_controller/examples/dashboard.yaml`](custom_components/room_climate_controller/examples/dashboard.yaml).

## Development

This repo uses the standard HA integration dev scaffold (devcontainer + `config/`):

- `scripts/develop` — run Home Assistant locally against `config/`.

- `scripts/lint` — run ruff.

- `python3 custom_components/room_climate_controller/tests/test_engine.py` — engine

  unit tests (no HA required).

- `cd custom_components/room_climate_controller/card && npm install && npm run build`

  — rebuild the Lovelace card (edit `card/src/*.ts`, not the generated `www/` bundle).

See [CLAUDE.md](CLAUDE.md) for an architecture overview and [CONTRIBUTING.md](CONTRIBUTING.md).

### Installing integrations manually for testing

* Download zip file of custom component

  * wget https://github.com/JeffSteinbok/hass-dreo/releases/download/v1.9.10/pydreo_community-1.9.10.tar.gz