{"id":15351824,"url":"https://github.com/tbouron/ha-agur","last_synced_at":"2026-02-01T20:02:46.349Z","repository":{"id":212351875,"uuid":"731302513","full_name":"tbouron/ha-agur","owner":"tbouron","description":"Home Assistant integration for Agur https://ael.agur.fr","archived":false,"fork":false,"pushed_at":"2024-10-17T21:42:04.000Z","size":793,"stargazers_count":0,"open_issues_count":0,"forks_count":1,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-06-28T02:42:00.842Z","etag":null,"topics":["custom-integration","hacs","hacs-integration","history","home-assistant","integration","sensors","statistics","water"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/tbouron.png","metadata":{"files":{"readme":"README-FR.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}},"created_at":"2023-12-13T19:24:07.000Z","updated_at":"2024-10-17T21:35:04.000Z","dependencies_parsed_at":"2024-12-06T09:42:18.287Z","dependency_job_id":"6b55ba12-d8ea-474d-81ab-d7068b76968e","html_url":"https://github.com/tbouron/ha-agur","commit_stats":{"total_commits":34,"total_committers":2,"mean_commits":17.0,"dds":0.02941176470588236,"last_synced_commit":"1c08a5cf84c18614b480879505625660eedd7a6a"},"previous_names":["tbouron/ha-agur"],"tags_count":5,"template":false,"template_full_name":null,"purl":"pkg:github/tbouron/ha-agur","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tbouron%2Fha-agur","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tbouron%2Fha-agur/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tbouron%2Fha-agur/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tbouron%2Fha-agur/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/tbouron","download_url":"https://codeload.github.com/tbouron/ha-agur/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tbouron%2Fha-agur/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28988412,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-01T18:17:03.387Z","status":"ssl_error","status_checked_at":"2026-02-01T18:16:57.287Z","response_time":56,"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":["custom-integration","hacs","hacs-integration","history","home-assistant","integration","sensors","statistics","water"],"created_at":"2024-10-01T12:07:19.127Z","updated_at":"2026-02-01T20:02:46.331Z","avatar_url":"https://github.com/tbouron.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Intégration Agur for Home Assistant\n\nIntégration Home Assistant pour récupérer les informations de votre [compte Agur](https://ael.agur.fr) comprenant la consommation d'eau, dernière facture et balance comptable.\n\nVoir en [English](./README.md) | Français\n\n## Installation\n\n### Automatique (préférée)\n\n[![Ouvrir votre instance Home Assistant et ouvrir le dépôt à l'intérieur du Home Assistant Community Store.](https://my.home-assistant.io/badges/hacs_repository.svg)](https://my.home-assistant.io/redirect/hacs_repository/?owner=tbouron\u0026repository=ha-agur)\n\nOu:\n- Ouvrir votre instance Home Assistant.\n- Ouvrir HACS.\n- Cherchez `Agur`.\n- Cliquez sur le bouton `Télécharger` en bas à droite.\n- Redémarrer Home Assistant.\n\n### Manuelle\n\n- Copiez le dossier `agur` dans le dossier `/chemin/vers/home-assistant/custom_components/`.\n- Redémarrer Home Assistant.\n\n## Configuration\n\nCette intégration pour Home Assistant ne supporte pas la configurationvia le ficher de configuration `configuration.yaml`\ncar cette méthode n'est plus recommandée par Home Assistant. Pour configurer l'intégration, veuillez vous rendre sur\nHome Assistant -\u003e Paramètres -\u003e Appareils \u0026 Services et cliquez sur le bouton `Ajouter une intégration` dans l'onglet\n`Intégrations`\n\n![Configuration du compte](./img/config_flow_account_fr.png)\n\nPuis cliquez sur le bouton `Valider`. Vos identifiants seront validés et un nouveau écran vous sera proposé dans lequel\nvous pourrez configurer plusieurs options:\n- Les contrats disponibles et associés à votre compte.\n- Faut-il importer les statistiques de consommation dans Home Assistant.\n\nCes options peuvent être modifiées à n'importe quel moment, même après avoir ajouté votre compte Agur.\n\n![Paramètres du compte](./img/config_flow_options_fr.png)\n\n## Appareil\n\nPour chaque contrat ajouté, un nouvel appareil est créé dans Home Assistant qui correspond au compte d'eau associé au \ncontrat. Le nom par défaut est de numéro de série du compteur mais vous pouvez le changer à tout moment.\n\n![Écran de l'intégration](./img/integration_fr.png)\n\n## Capteurs\n\nPour chaque contrat ajouté, une série de 3 capteurs est créée:\n\n| Id                                       | Nom                                    | Description                                                                                                                         |\n|------------------------------------------|----------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------|\n| `sensor.agur_last_index_\u003ccontract_id\u003e`   | \u003cmeter_serial_number\u003e Dernier index    | Le dernier index relevé de manière automatique par le compteur (en Litres)                                                          |\n| `sensor.agur last_invoice_\u003ccontract_id\u003e` | \u003cmeter_serial_number\u003e Dernière facture | La dernière facture générée sur le contrat associé (en Euros)                                                                       |\n| `sensor.agur_balance_\u003ccontract_id\u003e`      | \u003cmeter_serial_number\u003e Solde du         | Le solde du pour le contrat. Ce capteur peut être utile lorsque celui passe au dessus des 0€ (pour des automatisations par example) |\n\nAll 3 sensors also have attributes for easy automation consumption\n\n| Id                    | Nom              | Description                                                                                 |\n|-----------------------|------------------|---------------------------------------------------------------------------------------------|\n| `date`                | Date             | La date réelle de changement de l'état du capteur                                           |\n| `contract_id`         | Abonnement       | Le numéro de contract                                                                       |\n| `contract_owner`      | Titulaire        | Le nom du titulaire du contrat associé                                                      |\n| `contract_address`    | Adresse          | L'adresse du contrat associé                                                                |\n| `meter_serial_number` | Compteur         | Le numéro de série du compteur associé                                                      |\n| `invoice_number`      | Facture          | Le numéro de facture (disponible uniquement pour `sensor.agur last_invoice_\u003ccontract_id\u003e`)  |\n| `payment_date`        | Date de paiement | La date de paiement réelle (disponible uniquement pour `sensor.agur_balance_\u003ccontract_id\u003e`) |\n\n![Sensors](./img/sensors_fr.png) \n\n## Statistiques\n\nSi vous avez coché l'option `Importer les statistiques pour les abonnements sélectionnés`, les données de consommation\ndes 3 dernières années seront alors importées dans le tableau de bord `Energie` de Home Assistant. Ces données seront\ncomplétées avec la consommation  journalière aussi longtemps que l'intégration sera activée.\n\n\u003e [!NOTE]\n\u003e L'API retourne les données de consommation avec 24 ou 48 heures de délais et ces données ne sont mises à jour qu'une \n\u003e fois par jour. Il est malheureusement impossible de récupérer des données plus détaillées.\n\n## Langues\n\nCette intégration fournie des traductions pour les langues suivantes:\n\n| Langue | Complète? |\n|--------|-----------|\n| EN     | :check:   |\n| FR     | :check:   |","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftbouron%2Fha-agur","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftbouron%2Fha-agur","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftbouron%2Fha-agur/lists"}