Repository navigation
Home

Welcome to the Humidity Intelligence support manual.
Humidity Intelligence is a deterministic environmental control engine for Home Assistant. The README is still the best place to start if you are installing the integration or checking the current release. This Wiki is for the longer, practical guides that help once you are using it in a real Home Assistant home.
Smaller Marketplace downloads, consistent air-quality units and clearer update status build on the continuing V2.1 Stability Score experience. CO emergency remains the highest-priority lane; missing or invalid clearance evidence keeps an active emergency latched.
See v2.1.2 release and upgrade guidance. On Home Assistant 2026.11+, use Settings → Marketplace; earlier supported versions retain HACS. Install the complete package and fully restart Home Assistant. Both V2 layouts now use revision 16; from beta.1 revision 14, v2.1.1 or earlier cards, refresh/export and replace the complete saved Manual-card YAML. Optional unconfigured sources are removed from generated JavaScript as well as YAML. Review sensor units and mappings before updating. Restart clears in-memory Stability history.
The final corrected package passed its own Stable-instance test: 13 passes, 3 explained warnings and no failures. Both saved revision-16 layouts showed UI current. The merged main source has the same tested component bytes; earlier Lab results retain their original package scope. Final stable Marketplace discovery and installation remain separate checks.
V2.1.2 is the current Stable release, published 8 November 2026. Verify the offered version and loaded version separately.
Thanks to @Slaybcn for reporting the installation failure and sharing logs in #145, and to @Thorsten1982 for confirming the same issue.
| Release | What it introduced | Details |
|---|---|---|
| v2.1.2 — Current Stable, 8 November 2026 | Home Assistant 2026.11 Harmonization | Changes and upgrade guide |
| v2.1.1 — 24 October 2026 | Single-level dashboards and update clarity | Upgrade guide · Release |
| v2.1.0 — 12 October 2026 | Stability Score, its supporting evidence and optional output monitoring | Stability Score · Release |
V2.1.0 was published at 17:28 UTC from immutable commit
6da820967173d3d29910c909a3a2a688965aa3ac. Its revision-9 card compatibility remains
historical; follow the guidance for the version you install.
For older releases, use the complete changelog or GitHub release history.
Use this manual when you want to:
- ask for help
- download diagnostics
- walk through configuration
- understand why a control decision happened
- understand why environmental stability matters
- understand generated dashboards
- handle air-quality and carbon-monoxide safety boundaries
- troubleshoot Marketplace or HACS update visibility
- find quick answers to common questions
This manual is written for people who already know their way around Home Assistant. It keeps the explanations practical, avoids hidden assumptions, and always points back to the repository when behavior matters.
-
Getting Help
What to include when opening a support issue. -
Diagnostics and Support Bundle
How to download Home Assistant diagnostics and what it helps maintainers see. -
Generated Dashboards
How generated cards, dashboard exports, and optional frontend cards fit together. -
Stability Score Understand the score, evidence, recent movement and history.
-
Output Monitoring Configure optional device observation and the adaptive Outputs view.
-
Migration Guide — V1 to V2 Replace the template-based V1 backend with the structured integration.
-
UI Gallery Browse reusable mobile, tablet, and legacy-compatible Humidity Intelligence card examples.
-
Services Reference Compact service guidance for dashboard exports, diagnostics, validation, runtime pause/resume, visual alert tests, and local HI snapshots.
-
Marketplace, HACS and Updates What to check when Marketplace, HACS or Home Assistant still shows an older version.
-
FAQ
Short answers to common questions.
-
Configuration Walkthrough A practical first-install and options-flow guide.
-
Understanding Control Decisions How HI chooses one explainable lane per cycle.
-
Why Environmental Stability Matters Why humidity, condensation, dry air, sleep comfort, and property protection matter in a real home.
-
Air Quality and CO Safety How AQ support fits into HI, including carbon-monoxide safety responsibilities.
-
Troubleshooting Generated UI What to check when generated cards, chips, or exports look wrong.
-
Release Validation for Users A user-safe checklist after updating.
This Wiki explains Humidity Intelligence in practical user language.
Runtime behavior, entity semantics, generated dashboard logic, diagnostics, services,
release state, and migration requirements live in the repository source,
README.md, docs/, ui-gallery/, manifest.json, hacs.json, and release notes.
When the manual and repository source need alignment, the repository source carries the current truth and a documentation issue helps bring the manual back into sync.
| Previous | Next |
|---|---|
| Release Validation for Users | Getting Help |
Explore our other projects
![]()
Thermal Intelligence →
- Home
- v2.1.2 Stable — Home Assistant 2026.11 Harmonization
- v2.1.1 historical upgrade guidance
- Getting Help
- Diagnostics and Support Bundle
- Generated Dashboards
- Stability Score
- Output Monitoring
- Migration Guide — V1 to V2
- UI Gallery
- Services Reference
- Marketplace, HACS and Updates
- FAQ