Skip to content

Latest commit

 

History

History
79 lines (64 loc) · 4.01 KB

README.md

File metadata and controls

79 lines (64 loc) · 4.01 KB

VentWise

VentWise banner

Latest release CI status HACS Default Apache-2.0 license Home Assistant integration Python 3.11 or later Downloads Stars

A Home Assistant custom integration for weather-aware window ventilation and indoor-comfort recommendations.

VentWise helps users decide when opening or closing windows is likely to improve indoor comfort. It evaluates a standard weather source, optional outdoor temperature, humidity, and wind overrides, and the configured comfort target, then exposes a clear recommendation back to Home Assistant.

Warning

Beta software - use recommendations with care. VentWise has automated CI coverage and limited real-world use, but it has not been exhaustively tested across all homes, sensors, weather conditions, or hardware. It provides informational recommendations only; it is not a safety, security, weather- protection, or automation-control system. Optional room automations require an explicit Companion App notification confirmation. Always assess the actual conditions before opening or closing anything, and do not rely on VentWise to prevent injury, property damage, intrusion, rain exposure, or equipment damage. See the full license, disclaimer, and reporting guidance.

At a glance

  • Comfort-based recommendation engine
  • Multi-room support
  • Room management from the Home Assistant UI
  • Summer and winter behavior
  • Quiet hours and cooldowns
  • Persisted runtime state across restarts
  • HACS-ready packaging

Installation

VentWise is available in the default HACS catalogue; no custom repository is needed.

  1. Open HACS in Home Assistant and select Integrations.
  2. Search for VentWise, open it, and select Download.
  3. Restart Home Assistant when prompted.
  4. Open Settings > Devices & services > Add integration, then select VentWise to configure it.

Stable releases are published from main. Experimental prereleases from the test branch family are for testing only.

Documentation

License

Apache License 2.0. See LICENSE and NOTICE.