Patterns over 72 hours
The score combines humidity, steadiness, room balance, moisture risk, configured air quality and recovery across a 72-hour window.
Humidity Intelligence · V2.1.1
A clearer picture.
A steadier home.
Humidity Intelligence coordinates humidity and air quality control for Home Assistant and explains each response. V2.1.1 brings single-level dashboards and clearer update status, alongside Stability Score’s longer view of conditions.
Explore Stability Score Install the current Stable release
V2.1.1 · Stable
Single-level dashboards, clearer update status and more reliable readings and reports.
V2.1.1 · 24 October 2026. Check the version offered in HACS before updating. Read the v2.1.1 release notes.
01 / The integration
About Humidity Intelligence
Humidity Intelligence is a Home Assistant integration for managing humidity and air quality. It uses your configured room sensors to assess conditions, including condensation and mould risk, and coordinate ventilation, air purifiers, humidifiers and dehumidifiers.
Its control decisions follow defined priorities and the active humidity profile. The dashboard brings readings, device status and the reason for each response together, making the system straightforward to understand and troubleshoot.
02 / The bigger picture
One reading is a moment.
Stability tells you more.
A comfortable reading can hide recurring humidity imbalance, moisture risk or slow recovery. Stability Score puts that reading in context by showing how conditions have varied over time.
An explained score
Tap the Stability badge in your HI dashboard to inspect the contributions, deductions and available history behind the score.
Context alongside the score
Missing evidence can limit the score or make it unavailable. Alerts, device status and the reason panel remain separate sources of current information.
How the score, history and display work
Stability is observational: it does not select control lanes or write outputs. Existing priority rules determine the control response. The score requires sufficient valid history and usable current evidence. Restarting or reloading the integration clears that history and starts collection again.
The badge's recent-change arc compares the current score with a reference from within the past 60 minutes. This is separate from the 72-hour score and the history recorded at ten-minute intervals. LED colour reflects the most recent update, which may differ from the overall direction shown by the arc.
Press and hold the Stability badge to display Disabled; repeat to restore the normal display. This saved preference affects presentation only: calculation, history and control continue. Each environmental badge uses its own recorded source.
03 / Everyday control
Control for
changing conditions.
Cooking, showers and indoor laundry affect rooms differently. HI assesses those changes against your active humidity targets and coordinates the devices you have configured.
Defined control priorities
A fixed priority order selects one ventilation lane per evaluation cycle. Humidification follows its own demand, while the reason panel explains the selected response.
Seasonal and custom targets
Room conditions are assessed against the active humidity profile. Auto follows the seasons; you can also select a season or set custom targets.
Visible decisions and device status
The dashboard shows the readings and evidence behind each response. Optional output monitoring reports configured device states and identifies gaps in monitoring.
HI relies on the sensors and devices you configure and complements appropriate ventilation, heating and maintenance. A device reported as On in Home Assistant is not proof of physical airflow or moisture production.
04 / See it in context
Readings and responses,
with the reasoning visible.
These screenshots show monitoring and air-quality control in an earlier V2.1 candidate. They retain the previous badge layout and autumn target range of 47–58%. The current autumn range is 50–60%, with humidity danger at 64%; these profile boundaries are not universal safety thresholds.
More views: humidification and output monitoring
05 / Platform and installation
Built for Home Assistant.
Install HI through the Home Assistant Community Store (HACS), or explore Home Assistant before setting up a system.
Home Assistant
New to Home Assistant?
Your home, connected
on your terms.
Home Assistant is an open-source platform that runs locally on your own hardware to connect and automate compatible devices. Humidity Intelligence is an independent integration for that platform.
Start with Home AssistantThe official guide covers hardware selection, installation, device connections and automations.
Humidity IntelligenceHome Assistant integrationAlready using Home Assistant?
Install Humidity
Intelligence.
HI is included in the HACS default integration repository. Install the published Stable package, then follow the setup guide to map room sensors, configure outputs and add the dashboard.
Open in HACSThe button opens HI's repository page in HACS. Check the published version in GitHub Releases and refresh repository information if an older version is shown.
Read the complete installation guide
v2.1.1 · Stable
Dashboards that follow your home.
Single-level homes need no dummy second level. Saved Options drive the exported cards, configured unavailable sensors stay visible, and HACS update evidence stays separate from card compatibility. Calculated trends use the last actual reading in each minute; this can affect slope-based decisions.
Install the complete package and restart Home Assistant. From v2.1.0 or older cards, run refresh_ui, export with view_cards or dump_cards, replace the complete saved YAML and refresh the client. Existing v2.1.1-beta.4 and v2.1.1-rc.1 revision-13 cards remain compatible. No configuration or entity migration is required; restarting clears Stability history.
Read the release notesUnderstand your home
From readings
to informed decisions.
Explore how HI coordinates control, explains moisture risk and puts changing conditions in context.
Keep exploring
Documentation
and support.
Support Humidity Intelligence
Help improve
Humidity Intelligence.
Practical feedback, reproducible issue reports and clear examples help improve HI. You can also star the repository to help others discover it, or sponsor its ongoing maintenance.