Rebond sur le sujet : Transfert zigbee2mqtt HA vers Gladys

Je rebondis sur le sujet : est-ce qu’il serait possible de proposer un outil facilitant la migration de Home Assistant vers Gladys ?

J’imagine que beaucoup de personnes qui utilisent actuellement Home Assistant hésitent à franchir le pas, notamment parce qu’elles ont peur de devoir tout reconfigurer manuellement.

Je ne sais pas quelle serait la meilleure solution : une application indépendante, une intégration directement dans Gladys ou un autre système permettant de récupérer automatiquement une partie de la configuration existante.

L’idée serait de faciliter au maximum la transition en permettant, par exemple, de récupérer les équipements, les pièces, les noms et éventuellement certaines automatisations, sans devoir repartir de zéro.

Je ne sais pas ce qui est techniquement réalisable, ni jusqu’où on pourrait aller dans la récupération des données, mais je pense que ce serait une piste intéressante à explorer pour attirer de nouveaux utilisateurs vers Gladys.

Bonne question ! J’ai regardé (enfin Claude :wink: ) le code de Gladys et le catalogue des intégrations. En résumé : oui, c’est faisable, et une bonne partie des briques existe déjà. Il faut juste découper le problème, parce que chaque morceau ne se traite pas au même endroit.

Ce qui existe déjà

  • Le pont Home Assistant de @guim31 (gladys-homeassistant, Gladys 5.3 ou plus) : il importe les appareils HA dans l’onglet Découverte et les pilote à travers HA. HA doit donc rester allumé, et les pièces HA ne sont pas recréées dans Gladys (elles servent à filtrer et sont ajoutées au nom).
  • La migration d’appareil (le bouton « Migrer » des intégrations dépréciées) : elle déplace l’historique, réécrit les scènes et les dashboards, et reprend la pièce. La destination peut être n’importe quel appareil, Zigbee2MQTT compris.
  • La sauvegarde Zigbee2MQTT en base : Gladys sait déjà restaurer un zip du dossier Z2M quand il installe le conteneur.
  • Le serveur MCP de Gladys sait créer des scènes, et le chat IA de Gladys utilise les mêmes outils.

Ce qu’on pourrait ajouter

  1. Importer une sauvegarde Z2M (.zip) depuis l’intégration Zigbee2MQTT. Le frontend Z2M de HA fournit ce zip (Settings → Tools → Download data folder backup). Gladys corrigerait lui-même homeassistant: false et server: mqtt://localhost:1884, puis lancerait l’installation. Ce serait l’option B du sujet d’Olivier, sans SSH. Attention : il faut garder le même dongle, car la sauvegarde du coordinateur ne passe pas d’une puce à une autre.
  2. Afficher le bouton « Migrer » sur les appareils des intégrations externes. L’API existe déjà. On pourrait alors basculer un appareil du pont HA vers son équivalent Z2M natif sans perdre les scènes, les dashboards, la pièce ni l’historique.
  3. Ajouter une « pièce suggérée » au contrat des intégrations externes. Aujourd’hui, une intégration ne peut ni créer ni affecter une pièce, et c’est voulu : c’est le choix de l’utilisateur. Si elle pouvait suggérer une pièce, l’écran Découverte la pré-remplirait et proposerait de la créer. Ça servirait au pont HA, mais aussi aux ponts Jeedom, Homey, Domoticz et eedomus.
  4. Pour les automatisations, plutôt un tuto qu’un convertisseur : un agent IA branché à la fois sur un MCP Home Assistant et sur le MCP Gladys. Le MCP officiel de HA ne lit pas les automatisations : il faut un MCP communautaire comme ha-mcp, ou simplement coller son automations.yaml. Les cas simples (déclenchement sur un état, une heure ou le soleil, puis action sur un appareil) devraient se traduire directement. Les templates Jinja, les blueprints et les choose seront à reprendre à la main.

Le parcours que ça donnerait

  1. Installer le pont HA : tout apparaît dans Gladys, on crée ses pièces, ses scènes et ses dashboards, et HA tourne toujours.
  2. Importer le zip Z2M : le Zigbee passe en natif dans Gladys.
  3. « Migrer » chaque appareil du pont vers son équivalent Z2M.
  4. Recréer les automatisations restantes avec l’IA.

On ne repart jamais de zéro, et on peut revenir en arrière tant que l’étape 2 n’est pas faite. Resteront manuels : les appareils ZHA (à réappairer), les intégrations HA sans équivalent dans Gladys (elles restent derrière le pont) et les dashboards Lovelace.

@pierre-gilles, qu’en penses-tu ? L’import du zip Z2M et le bouton « Migrer » sur les intégrations externes me semblent assez petits, puisqu’ils réutilisent la restauration Z2M et l’API de migration existantes. La pièce suggérée touche au contrat des intégrations externes, donc à valider avec toi. Si ça te va, je peux proposer la PR de l’import du zip Z2M.

@guim31, la pièce suggérée t’intéresserait-elle pour ton pont ? D’après le README, il a surtout été testé avec l’intégration demo de HA : des retours sur de vraies installations seraient sûrement utiles.

Pourquoi pas, mais c’est quand même une proposition très “développeur”, cela demande de savoir où sont les fichiers côté HA, et savoir les récupérer, chose que l’utilisateur ne sait pas forcément faire. C’est pas optimal.

Je ne pense pas que ce soit une solution, car cela demande dans tous les cas de configurer l’intégration avant, et donc de récupérer tous ses appareils directement.

En plus, il n’y a rien à migrer : l’utilisateur n’aura pas créé de scènes, ni de tableaux de bord, et n’aura pas d’historique de données. C’est une fausse sécurité, l’utilisateur pensera que la data sera prise de HA, alors que rien ne sera fait !

En revanche, je rebondis sur la proposition de @Prof_Techno qui est la bonne à mon avis :

C’est une très bonne idée !

Ça pourrait être développé sous la forme d’une intégration native dans le core je pense, qui du coup aurait tous les droits pour importer tout depuis HA.

De mon côté je ne pourrais pas travailler sur ce sujet avant mon congé paternité.

En revanche, @cicoub13 et @bertrandda ont tous les droits sur ces sujets, donc si vous pensez que c’est une priorité, vous êtes libre de le faire entre vous :wink:

@mutmut oui, la pièce suggérée m’intéresserait pour le pont HA : dès que le cœur la propose, je l’ajoute à l’intégration. Et si l’import natif dont parle Pierre-Gilles voit le jour, le pont restera utile pour tout ce qui n’a pas d’équivalent dans Gladys :slightly_smiling_face:

@pierre-gilles @guim31 ok pour vos remarques, je ne vais pas pousser Claude plus loin, si un outil de migration peut être intégré dans le coeur, c’est parfait :slight_smile:

Au contraire, si tu veux lancer ton Claude sur le sujet dans le cœur, c’est avec plaisir !

J’ai l’impression que c’est un gros chantier mais je suis partant pour lancer Claude dessus si personne n’est preneur (période creuse pour moi). Le seul bémol c’est que je n’ai jamais touché à HA…

De manière générale, les tests en réel vont être délicats (mais tout en écrivant ça, je me dis qu’il “suffit” de d’abord faire l’inverse, une migration automatique vers HA :stuck_out_tongue: )

Ca risque d’être un gros chantier effectivement, ça c’est sûr, car quand ça marchera (je n’ai pas trop de doute :sweat_smile:), viendront les “migrateurs” pour jeedom, zibase, zipato (si il y en a encore), homey, et sûrement d’autres :slight_smile:

Vu l’enthousiasme, je suis en train de rédiger une spec avec Claude.

Puis-je compter sur vous pour la relecture ? C’est ma première fois :innocent:

Le repo est ici : GitHub - gboulvin/HA2Gladys-Migration-Tool · GitHub

Je suis toujours en pleine réflexion donc ne vous précipitez pas (je signale juste que je suis dessus pour ne pas faire le travail deux fois) !

Hello !

La spécification en V1 est écrite.

Je vous propose de discuter de la suite ici :

https://community.gladysassistant.com/t/outil-de-migration-home-assistant-gladys-presentation-specs-et-modifications-du-coeur