https://github.com/teh-hippo/ha-home-rules
Solar-aware aircon automation as a Home Assistant custom integration
https://github.com/teh-hippo/ha-home-rules
aircon automation hacs home-assistant home-automation homeassistant hvac raspberry-pi solar
Last synced: about 2 months ago
JSON representation
Solar-aware aircon automation as a Home Assistant custom integration
- Host: GitHub
- URL: https://github.com/teh-hippo/ha-home-rules
- Owner: teh-hippo
- License: mit
- Created: 2026-02-13T06:37:50.000Z (5 months ago)
- Default Branch: master
- Last Pushed: 2026-04-27T23:08:40.000Z (2 months ago)
- Last Synced: 2026-04-28T01:12:42.490Z (2 months ago)
- Topics: aircon, automation, hacs, home-assistant, home-automation, homeassistant, hvac, raspberry-pi, solar
- Language: Python
- Size: 1.42 MB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# Home Rules
[![HACS][hacs-badge]][hacs-url]
[![GitHub Release][release-badge]][release-url]
[![Validate][validate-badge]][validate-url]
[![Home Assistant][ha-badge]][ha-url]
Solar-aware aircon automation for Home Assistant.
## Features
- Uses one **Control Mode** selector (**Disabled / Dry Run / Live / Aggressive**).
- Exposes decision sensors so you can see why a mode/action was chosen.
- Can optionally send mode-change alerts to a `notify.*` target.
- Runtime integration code is intentionally compact to keep maintenance overhead low.
## Installation
Install through HACS as a custom repository:
1. Add `https://github.com/teh-hippo/ha-home-rules` as an **Integration** repository.
2. Install **Home Rules**.
3. Restart Home Assistant.
## Configuration
Add **Home Rules** from Settings -> Devices & Services, select your entities, then tune options.
Home Rules manages its own aircon timer internally, so you do not need a separate `timer.*` helper entity.
`select.home_rules_control_mode` defaults to **Monitor** for safe setup. Switch to **Solar Cooling** once you're happy with decisions and want the integration to control your climate entity.
## Development
```bash
bash scripts/check.sh
```
Requires [uv](https://docs.astral.sh/uv/). Uses [Conventional Commits](https://www.conventionalcommits.org/).
## Troubleshooting
- Verify all configured entities exist and are available.
- Keep Control Mode in **Dry Run** until behavior matches expectations.
- Check Home Assistant logs for `home_rules` issues.
## License
MIT
[hacs-badge]: https://img.shields.io/badge/HACS-Custom-41BDF5.svg
[hacs-url]: https://github.com/hacs/integration
[release-badge]: https://img.shields.io/github/v/release/teh-hippo/ha-home-rules
[release-url]: https://github.com/teh-hippo/ha-home-rules/releases
[validate-badge]: https://img.shields.io/github/actions/workflow/status/teh-hippo/ha-home-rules/validate.yml?branch=master&label=validate
[validate-url]: https://github.com/teh-hippo/ha-home-rules/actions/workflows/validate.yml
[ha-badge]: https://img.shields.io/badge/HA-2026.2%2B-blue.svg
[ha-url]: https://www.home-assistant.io