Temperature, control and context in one Home Assistant card.
Website · Wiki · Install RC.1 · Configuration · Compatibility
Thermal Intelligence brings current and target temperatures, supported thermostat controls and useful room observations into one considered interface. The glass dial, restrained lighting and focused detail panels keep everyday readings clear and further detail close at hand.
RC.1 is the standalone thermostat release candidate. Start with a standard Home Assistant climate entity or Versatile Thermostat (VT), then choose the readings and controls that suit each room.
| Heat requested · rising | Idle · near target |
|---|---|
 |
 |
| TRV closed · falling | Above target · rising |
 |
 |
Selected installation examples. Explore the state gallery and image context.
| At a glance | What you can read |
|---|---|
| Glass dial and outer arc | Current temperature, a target marker and colour that follows the room’s reported state and temperature response. Drag the marker or use minus/plus within the thermostat’s supported limits. |
| Temperature-slope ring | Rising, falling or steady temperature, with a readable rate and units alongside the colour. |
| Status chip | Reported Heating, Cooling or Idle; VT heat requests; or TRV Open/Closed with a mapped valve percentage. Tap for the source behind the status. |
| Status LED | Green for readiness, amber for restrictions or observations needing attention, and red for a disconnected or unavailable thermostat. Tap for provider details and request status. |
The arc, slope ring and status chip describe different parts of the room’s story. A valve can close while the room temperature continues to rise. The reading guide explains these combinations and the observations used for each colour.
Choose top-row readings, their order, labels and icons independently for each card. Humidity, trend, window, presence, motion and valve sources each add useful context. Configured icons open focused panels; missing or unknown readings remain clearly identified.
Set your own humidity display bands, select Midnight Blue, Plum or Black, and choose which details appear. The visual editor saves those preferences with the card.
The chevron opens Controls & features: supported modes, presets, fan or swing choices, and provider details. VT adds preset-temperature comparisons, feature observations and administrator lock controls where supported. When VT reports no optional Off or Mode reason, the overview shows None reported.
Explore configuration · See the detail panels
Use one card for a compact room view, or arrange several independently configured cards across a wider dashboard. The layout adapts to the available space, with touch-sized controls, keyboard access and reduced-motion support.
Start in Add Card → Thermal Intelligence Thermostat · RC. Select the climate entity, then map optional humidity, trend and valve sources. TI works directly with Home Assistant and your thermostat provider.
An installation example showing independently configured rooms. More layouts and states.
| Responsibility | Owner |
|---|---|
| Device reports, room/outdoor measurements, context and energy | Devices and data providers |
| Card, mapped observations and validated user requests | TI frontend |
| States, registry and service access | Home Assistant |
| Regulation, schedules and device operation | Thermostat provider |
TI brings together the observations you select. Thermostats, TRVs, independent room sensors, outdoor readings, window/presence sensors and energy sources reach the card through Home Assistant. The climate entity and optional sensor mappings follow separate paths, so each reading keeps its source and status.
TI sends the actions you choose through Home Assistant’s services. Your thermostat provider retains regulation, schedules and device behaviour. Architecture and ownership.
The manual installation guide provides the exact RC.1 module, SHA-256, setup and rollback steps. Keep existing TI resources in place and load one trial module at a time. Saved trial cards retain their configuration and custom:thermal-intelligence-beta-card type.
RC.1 is published for a controlled HACS trial. Prerelease v0.1.0-rc.1 contains the module, licence and package manifest. Upstream HACS validation and isolated installation checks remain pending; this route is not yet recommended for existing installations. Follow HACS preparation for the trial gates. Marketplace remains part of the distribution roadmap.
Compatibility and validation records the tested versions, RC checks and remaining device coverage. RC.1 is a release candidate, with stable release acceptance tracked separately.
The standalone thermostat is the first component. Planned work includes House Climate, Effective Mode, Heating Control Centre, a portable backend and broader mobile/tablet dashboards. These will build on explicit ownership and explainable provider observations.
Useful reports include your TI, Home Assistant and provider versions, reproduction steps and a redacted configuration. Use the issue forms, or read Contributing for code and documentation changes. Changelog.
Report vulnerabilities through private vulnerability reporting. Security explains what to include and how to keep sensitive details private.
Star the repository, share useful feedback, or sponsor development.
Software is licensed under GPL-3.0-only. Documentation and artwork have separate reuse terms.
Explore our other projects
Humidity Intelligence →