Comment mettre en place un magasin communautaire adjoint à domicile (et pourquoi vous devriez)
Home Assistant est une plate-forme de maison intelligente vertigineusement puissante, grâce en grande partie à sa vaste gamme d'intégrations. Mais l'installation de vanille n'est que la pointe de l'iceberg.
Il y a une communauté dynamique qui est en dehors du projet «officiel» et de ses intégrations principales. La bonne nouvelle est que l'accès aux créations communautaires est aussi simple que d'ajouter une autre intégration.
Le magasin communautaire adjoint à domicile, ou HACS, comme on l'appelle communément, est une collection d'éléments personnalisés à la communauté pour l'assistant Home Assistant Home Platform Home open source. Il prend la forme d'une intégration, le projet désireux de souligner que ce n'est pas un module complémentaire. Il s'agit d'une distinction importante car les modules complémentaires sont des packages de logiciels autonomes qui s'exécutent sur le système d'exploitation d'assistant à domicile sous-jacent.
Pensez aux modules complémentaires comme des programmes séparés qui fonctionnent aux côtés (mais pas à l'intérieur) d'assistants à domicile. Les intégrations, en revanche, sont des extensions efficacement qui fonctionnent directement sur l'assistant à domicile, ajoutant des fonctionnalités ou apportant des modifications dans la plate-forme d'assistant à domicile (pas le système d'exploitation sous-jacent).
HACS rassemble un monde d'intégrations tierces qui pourraient autrement nécessiter une installation manuelle, simplifiant considérablement le processus en une question de recherche et d'installation en quelques clics. Avec HACS, vous pouvez rechercher et installer rapidement des éléments personnalisés qui ne sont pas officiellement soutenus par le projet principal d'assistant à domicile. Les éléments personnalisés incluent les intégrations, les tableaux de bord et les thèmes.
Si vous souhaitez étendre le nombre d'intégrations et autres éléments d'assistant à domicile auxquels vous avez accès, HACS est un incontournable. En plus de la liste de base des éléments transmis par la communauté, vous pouvez ajouter des référentiels personnalisés pour accéder à encore plus de téléchargements. Étant donné que HACS facilite l'installation de ces éléments personnalisés, le projet a été un succès auprès des développeurs et des utilisateurs finaux.
Une fois que vous avez installé l'application, vous verrez un onglet HACS Store dans l'interface Web d'assistant domestique que vous pouvez utiliser pour trouver, installer et gérer des éléments personnalisés. L'installation est un peu alambiquée, nous avons donc traversé le processus ci-dessous.
Vous avez besoin d'un compte GitHub gratuit afin d'utiliser HACS en raison de la façon dont le projet intègre les projets des référentiels en ligne. Les comptes GitHub non autorisés sont limités à 60 demandes d'API par heure, mais comme HACS a besoin de bien plus que cela, un compte enregistré est nécessaire.
Sommaire
Installation de HAC sur votre serveur
La façon dont vous installez HACS dépend en grande partie de l'installation d'assistant à domicile que vous utilisez. Pour le savoir, ouvrez votre interface Web d'assistant à domicile dans un navigateur et accédez à Paramètres>. En haut de l'écran, vous devriez voir la «méthode d'installation» répertoriée.
Home Assistant OS ou installation HACS supervisée
Il y a de fortes chances que votre méthode d'installation soit «Home Assistant OS» ou «supervisé», sauf si vous avez spécifiquement opté le contraire. Pour terminer l'installation, assurez-vous que vous êtes sur le même réseau que votre configuration d'assistant à domicile afin que vous puissiez accéder au tableau de bord principal.
Pour commencer, vous devez ajouter le référentiel HACS à l'installation de votre assistant domestique afin que vous puissiez utiliser le module complémentaire nécessaire pour terminer l'installation. Pour commencer, cliquez ici et vérifiez que l'URL que vous utilisez pour accéder à votre interface d'assistant à domicile est correcte.
Par défaut, ce sera: http://homeassistant.local:8123 Mais vous pouvez également utiliser l'adresse IP numérique pertinente, comme http://192.168.0.7:8123.
Cliquez sur «Enregistrer» puis «Ouvrir le lien» pour ouvrir votre interface d'assistant à domicile. Vous verrez une fenêtre contextuelle «complémentaire manquant» apparaître, cliquez sur «Ajouter» pour ajouter le référentiel nécessaire.
Une fois que vous avez fait cela, vous verrez une page qui vous invite à ajouter le module complémentaire «Get HACS», ce qui aidera à finaliser le reste du processus. Cliquez sur «Installer» pour le faire.
N'oubliez pas que HACS n'est pas un module complémentaire, mais que l'outil «Get HACS» est un ADD qui n'est utilisé que pour finaliser l'installation. Vous pourrez le supprimer plus tard une fois le processus terminé.
Une fois cela téléchargé, cliquez sur le bouton «Démarrer» pour démarrer le module complémentaire «Get HACS».
En haut de l'écran, vous verrez un onglet «journal», cliquez dessus et attendez que l'installation se termine. Lorsque vous voyez «Info: Installation terminée» apparaissent dans le journal, vous avez terminé.
Maintenant, redémarrez l'assistant à domicile et passez à la section «Configuration de HACS» ci-dessous.
Vous pouvez redémarrer l'assistant à domicile à partir de l'interface Web en cliquant sur Paramètres> Système et en utilisant l'icône «Power» dans le coin supérieur droit de l'écran.
Installation de Container HACS
Si vous avez installé l'assistant à domicile dans un conteneur Docker, vous pouvez installer HACS avec seulement quelques lignes de commande. Vous aurez besoin d'un accès direct au serveur pour ce faire.
Sur le serveur, ouvrez un terminal et entrez le conteneur à l'aide de la commande suivante:
docker exec -it Remplacer
wget -O - https://get.hacs.xyz | bash - Une fois terminé, redémarrez l'assistant à domicile et passez à la section «Configuration de HACS» ci-dessous.
Installation de Core HACS
Si vous avez une installation de base, vous devez savoir que cette méthode a été obsolète. Quoi qu'il en soit, vous pouvez toujours installer HACS en accédant au serveur et en exécutant le script suivant en tant qu'utilisateur qui exécute l'assistant à domicile:
wget -O - https://get.hacs.xyz | bash - Une fois terminé, redémarrez l'assistant à domicile et passez à la section «Configuration de HACS».
Configuration de HACS
Avec HACS installé, il est temps de l'intégrer dans la configuration de votre assistant à domicile et de faciliter la navigation sur les téléchargements disponibles. Tout d'abord, dirigez-vous vers les paramètres> Appareils et services. Effacez maintenant votre cache de navigateur ou effectuez un rafraîchissement dur dans votre navigateur en maintenant la touche Maj et en cliquant sur Rafraîchir.
Ensuite, cliquez sur «Ajouter une intégration» et recherchez «HACS» puis cliquez dessus.
Un pop-up apparaîtra. Lisez et acceptez les conditions, puis cliquez sur Soumettre.
Vous verrez maintenant une boîte de dialogue vous demandant d'autoriser votre appareil avec GitHub. Terminez le processus en créant un compte ou en vous connectant, puis cliquez sur «Continuer» et saisissez le code nécessaire à la demande. Enfin, cliquez sur «Autoriser HACS» pour accorder la permission HACS à votre compte GitHub.
Vous devriez voir un « vous êtes prêt! » message. Fermez l'onglet et retournez à HACS.
Vous verrez un message de réussite, après quoi vous pouvez créer un «appareil» pour HACS en l'attribuant à une zone et en cliquant sur «Terminer». Le magasin communautaire adjoint à domicile est maintenant installé et prêt à partir.
Accédez à votre panneau de configuration d'assistant à domicile dans un navigateur Web comme vous le feriez normalement et jetez un œil à la barre latérale. Une nouvelle entrée «HACS» sera apparue. Cliquez dessus et vous verrez une liste des éléments personnalisés disponibles que vous pouvez installer dès le départ.
Ceux-ci sont tous inclus dans le référentiel HACS «officiel». Vous pouvez rechercher des éléments ou utiliser des filtres pour réduire votre recherche. Cliquez sur un élément pour en savoir plus à ce sujet, puis utilisez le lien «Télécharger» en bas de la page pour l'ajouter à l'assistant à domicile.
Une fois que vous avez téléchargé un article, vous devrez l'ajouter à Home Assistant comme les autres. Par exemple, si vous ajoutez une intégration personnalisée à l'aide de HACS, vous devrez d'abord le télécharger à l'aide de HACS, puis dirigez-vous vers Paramètres> Appareils et services et cliquez sur «Ajouter une intégration», puis ajoutez-le à Home Assistant.
Beaucoup de ces intégrations ont des assistants de configuration automatisés qui vous aideront à les configurer. D'autres exigeront que vous ajoutiez du code à votre fichier «configuration.yaml» dans l'assistant à domicile manuellement. La page HACS Store pour tout ce que vous installez devrait le rendre clair.
Dans le cas où vous devez modifier votre fichier «configuration.yaml», vous devez installer le complément complémentaire «Éditeur de fichiers» simple à l'aide de paramètres> Add-ons> Add-on Store, puis de recherche de «l'éditeur de fichiers» suivi de l'installation. Vous pouvez ensuite visiter les paramètres> compléments> Explorateur de fichiers et cliquer sur «Web interne» pour modifier le fichier préalable via une interface Web.
Tous les éléments personnalisés que vous pourriez vouloir installer ne seront pas inclus avec HACS, auquel cas vous pouvez ajouter des référentiels personnalisés. Les instructions pour ce faire sont simples: ouvrez simplement le magasin HACS et cliquez sur l'icône «Three Dots» dans le coin supérieur droit.
Cliquez sur «REPOSITorités personnalisées», puis collez l'URL du référentiel que vous souhaitez ajouter dans la case, puis choisissez le type d'élément avec lequel il correspond. Donc, si vous installez un thème, vous choisissez «thème» (par exemple). Finalisez en cliquant sur «Ajouter».
Pour retirer un élément HACS, trouvez-le dans l'assistant domestique et retirez-le, puis trouvez-le dans HACS et retirez-le de là également.
Explorez maintenant le magasin HACS
Par défaut, HACS répertorie tous les téléchargements disponibles par le nombre de «Stars» qu'il a reçues sur GitHub. Les plus populaires seront au sommet, et ils font de grands points de départ.
Certaines vedettes incluent le constructeur du tableau de bord des champignons, le plugin d'éclairage adaptatif qui synchronise vos lumières avec le soleil, le moniteur Bluetooth à faible énergie Ble_Monitor Bluetooth et HA_LLMVISION pour incorporer la prise en charge multimodale LLM dans vos automations personnalisées. Il y a aussi un tas d'intégrations pour les appareils qui ne sont pas explicitement pris en charge par l'assistant à domicile par défaut de fabricants comme Alarmo, Xiaomi et Meross.
