{"id":42811234,"url":"https://github.com/dvd-dev/hilo","last_synced_at":"2026-05-22T02:14:41.393Z","repository":{"id":38204647,"uuid":"441028036","full_name":"dvd-dev/hilo","owner":"dvd-dev","description":"Home Assistant Hilo Integration via HACS","archived":false,"fork":false,"pushed_at":"2026-02-17T02:11:32.000Z","size":1356,"stargazers_count":228,"open_issues_count":11,"forks_count":42,"subscribers_count":15,"default_branch":"main","last_synced_at":"2026-02-17T07:04:13.580Z","etag":null,"topics":["hilo","home-assistant","home-automation","home-automation-system","hydro-quebec","signalr-client"],"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/dvd-dev.png","metadata":{"files":{"readme":"README.en.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE","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},"funding":{"github":"ic-dev21","custom":"https://paypal.me/icdev21"}},"created_at":"2021-12-23T01:25:40.000Z","updated_at":"2026-02-17T02:11:36.000Z","dependencies_parsed_at":"2026-01-03T03:00:20.125Z","dependency_job_id":null,"html_url":"https://github.com/dvd-dev/hilo","commit_stats":null,"previous_names":[],"tags_count":112,"template":false,"template_full_name":null,"purl":"pkg:github/dvd-dev/hilo","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dvd-dev%2Fhilo","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dvd-dev%2Fhilo/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dvd-dev%2Fhilo/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dvd-dev%2Fhilo/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/dvd-dev","download_url":"https://codeload.github.com/dvd-dev/hilo/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dvd-dev%2Fhilo/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30071671,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-04T03:25:38.285Z","status":"ssl_error","status_checked_at":"2026-03-04T03:25:05.086Z","response_time":59,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":["hilo","home-assistant","home-automation","home-automation-system","hydro-quebec","signalr-client"],"created_at":"2026-01-30T05:13:16.575Z","updated_at":"2026-05-22T02:14:41.384Z","avatar_url":"https://github.com/dvd-dev.png","language":"Python","funding_links":["https://github.com/sponsors/ic-dev21","https://paypal.me/icdev21"],"categories":["Python"],"sub_categories":[],"readme":"[![Français][Françaisshield]][Français]\n[![English][Englishshield]][English]\n\n[![hacs][hacsbadge]][hacs]\n[![GitHub Release][releases-shield]][releases]\n[![GitHub Activity][commits-shield]][commits]\n[![Project Maintenance][maintenance-shield]][user_profile]\n[![License][license-shield]][license]\n[![pre-commit][pre-commit-shield]][pre-commit]\n[![ruff][ruff-shield]][ruff]\n[![calver][calver-shield]][calver]\n[![discord][discord-shield]][discord]\n[![Installations (analytics)][installs-shield]][analytics]\n\n\n# ⚠️ BREAKING CHANGE ⚠️\n\nHilo is closing down REST API endpoint /Devices. See issue #564. We have released v2026.3.2. Any installation that hasn’t upgraded to this version will no longer work for device readings.\n\nA bug slipped into v2026.3.2 and v2026.3.3: during a reload or a disconnect, the challenge sensor does not come back.\nFixed in v2026.3.4.\n\nAny issue opened by someone who hasn’t updated Hilo will be closed.\n\n# ⚠️ BREAKING CHANGE ⚠️\n\n**BETA**\n\nThis is a Beta version. There will likely be bugs, issues, etc. Thank you for your patience and for opening \"Issues\".\n\n\nPlease consult the [Wiki](https://github.com/dvd-dev/hilo/wiki) before opening issues, a lot of common questions are answered there.\n\n\n\n## 📌 Introduction\nThis unofficial HACS integration allows you to use [Hilo](https://www.hiloenergie.com/en-ca/) with Home Assistant. **It is not affiliated with Hilo or Hydro-Québec.**\n\n**⚠️ Do not contact Hilo or Hydro-Québec for issues related to this integration.**\n\n**⚠️ Please make your automations and API calls smartly — Hilo knows we’re here and lets us have access because we don’t abuse it, let’s keep it that way.**\n\n🔗 [Recommended minimum configuration](https://github.com/dvd-dev/hilo/wiki/FAQ-%E2%80%90-Français#avez-vous-une-configuration-recommandée)\n🔗 Blueprints: [NumerID](https://github.com/NumerID/blueprint_hilo) | [Arim215](https://github.com/arim215/ha-hilo-blueprints)\n🔗 YAML automation examples: [Automations](https://github.com/dvd-dev/hilo/tree/main/doc/automations)\n🔗 Lovelace interface examples: [Interfaces](https://github.com/dvd-dev/hilo/wiki/Utilisation)\n\n---\n\n## 🔥 Main Features\n✅ Supports switches and dimmers as lights\n\n✅ Thermostat control and temperature reading\n\n✅ Energy consumption monitoring of Hilo devices\n\n✅ Sensor for Hilo challenges and gateway\n\n✅ Configuration via user interface\n\n✅ Authentication via Hilo website\n\n✅ Outdoor weather sensor with changing icon\n\n\n📌 **To do**: Support for other devices, improvement of consumption meters, API documentation\n\n# ⚠️ Hilo Challenge Sensor ⚠️\n\n### Current State:\n- The `allowed_kWh` and `used_kWh` attributes are **partially functional**: the information arrives in fragments, and not all cases are handled yet.\n- Some information, such as `total_devices`, `opt_out_devices`, and `pre_heat_devices`, do not **persist in memory**.\n\n---\n\n## 📥 Installation\n### 1️⃣ Check Compatibility\n- The integration requires Hilo hardware installed and functional.\n- Tested on HA OS, Docker (ghcr.io), Podman. Other configurations may cause issues.\n- Ongoing issue on Podman/Kubernetes see [issue #497](https://github.com/dvd-dev/hilo/issues/497).\n\n### 2️⃣ File Installation\n#### 🔹 Option 1: Via HACS\n[![Install via HACS](https://my.home-assistant.io/badges/hacs_repository.svg)](https://my.home-assistant.io/redirect/hacs_repository/?owner=dvd-dev\u0026repository=hilo\u0026category=integration)\n\n1. Make sure you have [HACS](https://hacs.xyz/docs/use/download/download/) installed.\n2. In HACS, click `+ EXPLORE \u0026 DOWNLOAD REPOSITORIES`, search for \"Hilo\" and download it.\n3. Restart Home Assistant\n\n#### 🔹 Option 2: Manually\n1. Download the latest version from [GitHub](https://github.com/dvd-dev/hilo/releases/latest).\n2. Copy `custom_components/hilo` to Home Assistant's `custom_components` folder.\n3. Restart Home Assistant\n\n### 3️⃣ Add Integration to Home Assistant\n[![Add Integration](https://my.home-assistant.io/badges/config_flow_start.svg)](https://my.home-assistant.io/redirect/config_flow_start/?domain=hilo)\n\n1. Go to **Settings \u003e Devices \u0026 Services \u003e Integrations**.\n2. Click `+ ADD INTEGRATION` and search for \"Hilo\".\n3. Authenticate on the Hilo website and link your account.\n\n---\n\n## 📌 Power Consumption Tracking\nIf you want to use automatic generation of power consumption sensors, follow these steps:\n\n1. **Add the `utility_meter` platform**\n   Add the following line to your `configuration.yaml`:\n   ```yaml\n   utility_meter:\n   ```\n\n2. **Enable automatic generation**\n   - In the integration's user interface, click `Configure`.\n   - Check **Generate power consumption meters**.\n\n3. *(Optional)* **Restart Home Assistant**\n   - Wait about 5 minutes. The `sensor.hilo_energy_total_low` entity will be created and contain data.\n   - **The `status`** should be `collecting`.\n   - **The `state`** should be a number greater than 0.\n   - All created entities and sensors will be prefixed or suffixed with `hilo_energy_` or `hilo_rate_`.\n\n4. **Known error (to ignore)**\n   If you see this error in the Home Assistant log, it can be ignored:\n   ```\n   2021-11-29 22:03:46 ERROR (MainThread) [homeassistant] Error doing job: Task exception was never retrieved\n   Traceback (most recent call last):\n   [...]\n   ValueError: could not convert string to float: 'None'\n   ```\n\n5. **Manual addition to \"Energy\" dashboard**\n   Once created, meters will need to be added manually.\n\n---\n\n## ⚠️ Warning\nWhen activating meters, it is recommended to **remove old manual sensors** to avoid duplicate data.\n\nIf you encounter a problem and want to collaborate, enable **debug** logging and provide an excerpt from the `home-assistant.log` file. The method is explained below.\n\n---\n\n## ⚙️ Other Configuration Options\nYou can configure additional options by clicking `Configure` in Home Assistant:\n![alt text](image.png)\n### ✅ **Generate power consumption meters**\n- Automatically generates power consumption meters.\n- **Requires** the following line in `configuration.yaml`:\n  ```yaml\n  utility_meter:\n  ```\n\n### ✅ **Generate only total meters for each device**\n- Calculates only the total energy **without division** between low and high cost.\n\n### ✅ **Log request data and Websocket messages**\n- Requires **debug logging level** on the integration and `pyhilo`.\n- Allows detailed tracking for development and debugging.\n\n### ✅ **Lock `climate` entities during Hilo challenges**\n- Prevents any modification of temperature setpoints **during a challenge** Hilo.\n\n### ✅ **Track unknown consumption sources in a separate meter**\n- All **non-Hilo** sources are grouped in a dedicated sensor.\n- Uses the house's **smart meter** reading.\n\n### 📌 **Hydro-Québec rate name** (`rate d` or `flex d`)\n- Define the **rate plan name**.\n- **Supported values**:\n  - `'rate d'`\n  - `'flex d'`\n\n### ⏳ **Update interval (min: 60s)**\n- Sets the **number of seconds** between each update.\n- **Default value**: `60s`.\n- **Don't go below 30s** to avoid suspension from Hilo.\n- Since **2023.11.1**, the minimum has increased from **15s to 60s**.\n\n## 📌 FAQ and Support\n🔗 [Complete FAQ](https://github.com/dvd-dev/hilo/wiki/FAQ)\n💬 Join the community on [Discord](https://discord.gg/MD5ydRJxpc)\n\n**Problems?** Open an \"Issue\" with `debug` logs enabled in `configuration.yaml`:\n```yaml\nlogger:\n  default: info\n  logs:\n     custom_components.hilo: debug\n     pyhilo: debug\n```\n\n# 👥 Initial Contributors\n\n- **[Francis Poisson](https://github.com/francispoisson/)**\n- **[David Vallee Delisle](https://github.com/valleedelisle/)**\n\n## 🎖️ Very Honorable Mentions\n\n- **[Ian Couture](https://github.com/ic-dev21/)**: He has been maintaining this addon for some time.\n- **[Hilo](https://www.hiloenergie.com)**: Thanks to Hilo for their support and contributions.\n\n---\n💡 **Want to contribute?** Check out the [contribution section](/CONTRIBUTING.md) to see how to help with the project.\n\n[integration_blueprint]: https://github.com/custom-components/integration_blueprint\n[commits-shield]: https://img.shields.io/github/commit-activity/y/dvd-dev/hilo.svg?style=for-the-badge\n[commits]: https://github.com/dvd-dev/hilo/commits/main\n[hacs]: https://hacs.xyz\n[hacsbadge]: https://img.shields.io/badge/HACS-Default-41BDF5.svg?style=for-the-badge\n[license]: https://github.com/dvd-dev/hilo/blob/main/LICENSE\n[license-shield]: https://img.shields.io/github/license/dvd-dev/hilo.svg?style=for-the-badge\n[maintenance-shield]: https://img.shields.io/badge/maintainer-%40dvd--dev-blue.svg?style=for-the-badge\n[releases-shield]: https://img.shields.io/github/release/dvd-dev/hilo.svg?style=for-the-badge\n[releases]: https://github.com/dvd-dev/hilo/releases\n[user_profile]: https://github.com/dvd-dev\n[pre-commit-shield]: https://img.shields.io/badge/pre--commit-enabled-brightgreen?logo=pre-commit\u0026logoColor=white\u0026style=for-the-badge\n[pre-commit]: https://github.com/pre-commit/pre-commit\n[calver-shield]: https://img.shields.io/badge/calver-YYYY.MM.Micro-22bfda.svg?style=for-the-badge\n[calver]: http://calver.org/\n[ruff-shield]: https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json\u0026style=for-the-badge\n[ruff]: https://github.com/astral-sh/ruff\n[discord-shield]: https://img.shields.io/badge/discord-Chat-green?logo=discord\u0026style=for-the-badge\n[discord]: https://discord.gg/MD5ydRJxpc\n[Englishshield]: https://img.shields.io/badge/en-English-red?style=for-the-badge\n[English]: https://github.com/dvd-dev/hilo/blob/main/README.en.md\n[Françaisshield]: https://img.shields.io/badge/fr-Français-blue?style=for-the-badge\n[Français]: https://github.com/dvd-dev/hilo/blob/main/README.md\n[installs-shield]: https://img.shields.io/badge/dynamic/json?url=https://analytics.home-assistant.io/custom_integrations.json\u0026query=$.hilo.total\u0026label=Installations%20(analytics)\u0026color=blue\u0026style=for-the-badge\n[analytics]: https://analytics.home-assistant.io/custom_integrations.json","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdvd-dev%2Fhilo","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdvd-dev%2Fhilo","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdvd-dev%2Fhilo/lists"}