{"id":51480245,"url":"https://github.com/derabbink/ha_hacs_ventilation_assistant","last_synced_at":"2026-07-07T01:01:00.126Z","repository":{"id":367944639,"uuid":"1282863711","full_name":"derabbink/ha_hacs_ventilation_assistant","owner":"derabbink","description":"A Home Assistant HACS integration to assist with building ventilation","archived":false,"fork":false,"pushed_at":"2026-07-05T14:41:41.000Z","size":167,"stargazers_count":47,"open_issues_count":9,"forks_count":3,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-07-05T15:08:55.863Z","etag":null,"topics":["hacs","hacs-integration","home-assistant","home-assistant-custom-component","home-assistant-integration","humidity","indoor-air-quality","temperature","ventilation"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/derabbink.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-06-28T09:26:45.000Z","updated_at":"2026-07-05T13:50:16.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/derabbink/ha_hacs_ventilation_assistant","commit_stats":null,"previous_names":["derabbink/ha_hacs_ventilation_assistant"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/derabbink/ha_hacs_ventilation_assistant","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/derabbink%2Fha_hacs_ventilation_assistant","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/derabbink%2Fha_hacs_ventilation_assistant/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/derabbink%2Fha_hacs_ventilation_assistant/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/derabbink%2Fha_hacs_ventilation_assistant/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/derabbink","download_url":"https://codeload.github.com/derabbink/ha_hacs_ventilation_assistant/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/derabbink%2Fha_hacs_ventilation_assistant/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":35210429,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-07-06T02:00:07.184Z","response_time":106,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["hacs","hacs-integration","home-assistant","home-assistant-custom-component","home-assistant-integration","humidity","indoor-air-quality","temperature","ventilation"],"created_at":"2026-07-07T01:00:53.175Z","updated_at":"2026-07-07T01:01:00.101Z","avatar_url":"https://github.com/derabbink.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Ventilation Assistant\n\nVentilation Assistant is a Home Assistant custom integration for HACS. It creates virtual ventilation devices from existing indoor sensors, outdoor sensors, and door/window contacts.\n\n## Model\n\nThe integration is fully configurable from the Home Assistant UI. Configuration is stored by Home Assistant as config entries in `.storage/core.config_entries`; it does not create Home Assistant Helpers.\n\nUse the config flow to create:\n\n- one global defaults entry for the shared comfort temperature band, comfort relative-humidity band, and decision priority\n- one or more ventilation device subentries under that entry\n\n`priority` can be `TEMPERATURE` or `HUMIDITY`. Each device can override any global default, or leave that field empty to inherit the global setting.\n\nEach ventilation device creates a Home Assistant device containing:\n\n- Indoor temperature average\n- Indoor relative humidity average\n- Indoor absolute humidity\n- Indoor projected absolute humidity\n- Indoor projected relative humidity\n- Indoor projected relative-humidity difference\n- Indoor projected temperature difference\n- Outdoor temperature average\n- Outdoor relative humidity average\n- Outdoor absolute humidity\n- Any doors/windows open\n- Door/window open percentage\n- Temperature advice: `KEEP_CLOSED`, `OPEN`, `KEEP_OPEN`, or `CLOSE`\n- Humidity advice: `KEEP_CLOSED`, `OPEN`, `KEEP_OPEN`, or `CLOSE`\n- Advice: `KEEP_CLOSED`, `OPEN`, `KEEP_OPEN`, or `CLOSE`\n\n## Availability\n\nCalculated entities return unavailable when their required inputs are missing or unavailable:\n\n- Averages require at least one available source entity.\n- Absolute humidity requires temperature and relative humidity.\n- Projected indoor absolute humidity requires indoor temperature and outdoor absolute humidity.\n- Projected indoor relative humidity requires indoor temperature and projected absolute humidity.\n- Door/window sensors require at least one available contact sensor.\n- Advice requires either available indoor/outdoor temperature values or available\n  indoor/projected relative-humidity values. Without an available contact sensor,\n  advice is limited to `OPEN` or `CLOSE`.\n\n## HACS installation during development\n\nCopy or symlink this repository into Home Assistant, or add it as a HACS custom repository with category `Integration`. After installing, restart Home Assistant and add **Ventilation Assistant** from **Settings \u003e Devices \u0026 services**.\n\nComplete the global defaults form during first setup. After that, use **Add device** to add each ventilation device directly. Use the gear icon on the **Ventilation Assistant** integration entry to change the global defaults later. Use the configure action on a ventilation device subentry to change the input entities for that virtual device.\n\n## Local CI\n\nCreate the local development environment with:\n\n```sh\npipenv install --dev\n```\n\nRun the Python CI jobs individually with:\n\n```sh\npipenv run lint\npipenv run typecheck\npipenv run test\n```\n\nRun the GitHub Action backed checks with Docker running:\n\n```sh\npipenv run hacs-validate\npipenv run hassfest\n```\n\nRun the full local CI sequence with:\n\n```sh\npipenv run ci\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fderabbink%2Fha_hacs_ventilation_assistant","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fderabbink%2Fha_hacs_ventilation_assistant","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fderabbink%2Fha_hacs_ventilation_assistant/lists"}