Captures d’écran Extraites du README de goruck/home-generative-agent.
À propos
Home Generative Agent est un agent de conversation IA qui contrôle Home Assistant et écrit des automatisations à partir du langage courant. Il ajoute l'analyse des caméras avec reconnaissance faciale facultative, une mémoire sémantique à long terme conservée dans une base de données PostgreSQL avec pgvector, et un moteur d'anomalies appelé Sentinel qui envoie des alertes proactives. Les décisions de sécurité restent déterministes, le modèle de langage les conseillant sans jamais agir dessus. Il fonctionne avec des fournisseurs de modèles dans le cloud ou entièrement locaux, mais l'intégration elle-même nécessite la connexion cloud du fournisseur. Les notifications des caméras ont des réglages de délai d'attente par caméra et pour toute la maison, et les enregistrements d'événements Ring peuvent être analysés via ring-mqtt. Elle se configure dans l'interface, ajoute des entités image et capteur, et peut publier des avis de correction.
Résumé automatique du README et du code de goruck/home-generative-agent, traduit automatiquement. Une erreur, ou tu maintiens ce projet et tu veux ton propre texte ici ? Prendre contact
Prise en charge
Utilise le cloud du fournisseur Nécessite une connexion internet et un compte chez le fournisseur.
Depuis la Marketplace S’installe depuis la Marketplace, anciennement HACS.
Maintenance active Son auteur a publié une version ou poussé une modification au cours des six derniers mois.
Fournit
- Capteurs
Mise en place
Installe-la depuis la Marketplace et redémarre Home Assistant, puis ajoute-la dans Paramètres > Appareils et services.
Après la mise en place
- URL de l'API de reconnaissance faciale (facultatif)
- InstructionsIndique comment le LLM doit répondre. Il peut s'agir d'un modèle.
- Langue de description des caméras (facultatif)Langue des descriptions d'images de caméra par le VLM, par exemple « Czech ». Laisse vide pour l'anglais. La réponse interne « Scene unchanged. » reste toujours en anglais.
- Instructions supplémentaires pour l'analyse des caméras (facultatif)Instructions supplémentaires ajoutées au prompt d'analyse des caméras du VLM, par exemple « Ignore cars in the driveway ». Elles ne remplacent jamais les règles intégrées.
- Contrôler Home Assistant
- Mode de l'analyseur vidéo
- Activer le filtre d'images par hachage perceptuel (dHash)Ignore les images visuellement quasi identiques avant l'analyse par le VLM. Attention : l'activer supprime le contexte de mouvement entre les images que le modèle de résumé utilise pour décrire les mouvements. À n'activer que si une scène statique génère trop de doublons et que tu acceptes de perdre la continuité du mouvement.
- Analyser les enregistrements d'événements Ring (ring-mqtt, Ring Protect)Quand une entité event_select de ring-mqtt publie un recordingUrl signé avec un nouvel eventId, télécharge le MP4 de l'événement, extrait jusqu'à 8 images avec ffmpeg et les analyse à la place de l'instantané d'intervalle conservé, qui sur les caméras à batterie peut précéder l'événement de 10 minutes maximum. Nécessite un abonnement Ring Protect (les caméras sans recordingUrl continuent d'utiliser les instantanés) et le binaire ffmpeg fourni par l'image officielle de Home Assistant.
- Remplacements capteur de mouvement → caméra (facultatif)Un remplacement par ligne : binary_sensor.X_motion: camera.Y. Utilise-le quand la résolution automatique choisit la mauvaise caméra. Laisse vide pour t'appuyer sur la résolution par appareil et par nom.
- Service de notification de l'analyseur vidéo (facultatif)
- Délai d'attente des notifications de caméra (secondes)0 le désactive. Après le son d'une notification de caméra, les suivantes de cette caméra dans ce nombre de secondes (600 au maximum) remplacent la même notification en silence par la dernière légende et la dernière image, au lieu de sonner à nouveau. Avec la reconnaissance faciale activée, la première personne inconnue de cette période fait quand même sonner. Fonctionne uniquement avec un seul service notify d'app companion (notify.mobile_app_...).
- Délai d'attente des notifications de la maison (secondes)0 le désactive. Un événement vu par plusieurs caméras fait notifier chaque caméra. Après le son d'une notification de caméra, une notification de n'importe quelle caméra dans ce nombre de secondes (60 au maximum) publie quand même sa propre carte, mais en silence, et cette caméra reste ensuite silencieuse pendant son délai d'attente de notification de caméra, ou ce nombre de secondes s'il est plus long, à compter de ce son. Avec le délai de la caméra désactivé, chaque caméra, y compris celle qui a sonné, reste silencieuse pendant ce nombre de secondes. Avec la reconnaissance faciale activée, la première personne inconnue de cette période fait quand même sonner. Commence autour de 15 secondes : la vidéo de chaque caméra est analysée séparément, donc un événement peut atteindre les caméras à 10 à 30 secondes d'écart. Fonctionne uniquement avec un seul service notify d'app companion (notify.mobile_app_...) ; vérifié sur iOS uniquement.
- Activer la reconnaissance faciale
- Méthode de gestion du contexte
- Nombre maximal de jetons dans le contexte de discussion
Textes issus du code de goruck/home-generative-agent. Les textes que le dépôt ne fournit pas en français ont été traduits automatiquement.
Dépannage
- Avis de correctionLes avis qu’elle peut afficher dans Paramètres > Corrections :Home Generative Agent fonctionne sans base de données, Le code PIN des actions critiques ne protège pas les commandes vocales, Les règles de Sentinel pour les personnes inconnues ne peuvent pas se déclencher, Le stockage de mémoire contient les vecteurs d’un autre modèle d’embedding
Extrait du README
A Home Assistant integration that brings a generative AI agent into your smart home. Talk to your home, create automations in plain English, analyze camera footage, and get proactive alerts — all powered by your choice of cloud or local LLMs. HGA is a single integration that gives you conversational control over every HA entity, camera understanding with face recognition, long-term semantic memory, and the Sentinel anomaly engine.
Creating an automation in plain English — the agent writes the YAML, registers it, and it shows up in the HA automation editor.
S’affiche dans Vulpo :
carte Graphique, Apple Watch.Informations
- Installations
- 331 partagent leurs statistiques
- Étoiles GitHub
- 367
- Connexion
- Utilise le cloud du fournisseur
- Maintenance
- Mise à jour au cours des 6 derniers mois
- Version
- v3.44.10,
- Catégorie
- IA et voix, Modèles d’IA
- Type
- Intégration de la Marketplace
- Prérequis
- Nécessite la Marketplace (HACS sur Home Assistant 2026.10 et les versions antérieures)
- Domaine
home_generative_agent- Problèmes
- Signaler un problème














