Overview

Overview of the project

Origin of the project

This project was created to provide a way to access Hydro-Québec account and winter credit data for integration in home automation platforms such as Home-Assistant.

What information can be retrieved from my account?

  • General account data (billing period projection, current balance, current billing period consumption, and more)
  • Hourly consumption sent to Home-Assistant for use with the Energy Dashboard
  • Winter credit signals retrieved and used to trigger automations

What are the different components?

HydroQC python library

The HydroQC Python library is the base of the project and handles all calls to the Hydro-Québec customer portal.

hydroqc-ha - Home Assistant Custom Integration

Recommended

The hydroqc-ha custom integration is the recommended way to integrate Hydro-Québec with Home Assistant. It provides a native Home Assistant integration with all features built directly into Home Assistant.

Key features:

  • Native Home Assistant integration
  • Automatic sensor discovery
  • Energy dashboard integration
  • Support for winter credits and dynamic pricing
  • Multiple contract support

For new Home Assistant installations, use hydroqc-ha.


Supported Rates

Rates supported by the Hydroqc library.