A Home Assistant custom integration for comfort-based window 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.
- 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
- Reduce guesswork around when to open or close windows.
- Keep recommendations useful, quiet, and configurable from the Home Assistant UI.
- Support a clean HACS-first experience on both GitHub and Home Assistant.
- Make comfort rules understandable instead of hidden in automation logic.
Stable releases are published from main and remain the default latest version in HACS.
Experimental builds are published as GitHub prereleases from the test branch family.
Experimental builds are for testing only.
Coming soon.
- Project overview
- Domain model
- Scoring model
- Home Assistant integration
- Project rules
- Testing
- Development workflow
- HACS packaging
- Contributing
docs/: development and design documentationsrc/: reusable Python comfort enginecustom_components/ventwise/: Home Assistant custom integrationtests/: scoring and behavior testsbrand/: repo banner and icon assets
- Install the project in editable mode with the
devextra. - Run
pytestfor the local test suite. - Use
python ha-local-docker-test.pyfor a local Home Assistant sandbox that mounts the checked-out integration directly from the repo. - Keep repository hygiene rules in
.gitignore. - Keep the backlog in GitHub issues rather than duplicating it in the repo.
- CI validates HACS and Hassfest before releases.
- Release workflows publish an installable Home Assistant zip artifact.