Home Agent pour Home Assistant (intégration de la Marketplace)

Installations: 172 partagent leurs statistiques
Étoiles GitHub: 48
Connexion: Utilise le cloud du fournisseur
Maintenance: Mise à jour au cours des 6 derniers mois
Version: v0.9.5, 11 mai 2026
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_agent
Source: github.com/aradlein/hass-agent-llm
Problèmes: Signaler un problème

Annuaire indépendant, créé par le développeur de Vulpo. Non affilié à Home Assistant ni à l’Open Home Foundation.

À propos

Home Agent est une intégration de conversation qui connecte Home Assistant à des modèles de langage compatibles avec OpenAI. Elle fonctionne avec des services cloud ou des serveurs locaux comme Ollama, LocalAI et LM Studio, et se configure dans l'interface. Le contexte des entités peut être transmis au modèle soit à partir d'une liste fixe d'entités, soit en récupérant les entités pertinentes dans une base de données vectorielle ChromaDB. Des outils intégrés permettent au modèle de contrôler et d'interroger Home Assistant, et un second modèle externe facultatif peut être proposé pour les analyses complexes. L'historique des conversations peut être conservé après les redémarrages, et les sessions vocales peuvent être reprises entre les requêtes provenant du même appareil. Un système de mémoire extrait des faits et des préférences après les conversations, avec des limites sur les souvenirs stockés et un score d'importance minimal. Des actions sont disponibles pour réindexer les entités et pour effacer une conversation.

Résumé automatique du README et du code de aradlein/hass-agent-llm, 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.

Mise en place

Installe-la depuis la Marketplace et redémarre Home Assistant, puis ajoute-la dans Paramètres > Appareils et services.

Configurer Home Agent

Nom de l'intégrationUn nom convivial pour cette instance de Home Agent
URL de base de l'API LLMPoint d'accès d'API compatible avec OpenAI (par exemple api.openai.com/v1 ou localhost:11434/v1 pour Ollama)
Clé d'APIClé d'API pour l'authentification (laisse vide si elle n'est pas nécessaire)
Nom du modèleLe modèle à utiliser (par exemple gpt-4o-mini, llama3.1, etc.)
TempératureContrôle le hasard (0.0-2.0). Bas : plus ciblé, haut : plus créatif.
Nombre maximal de tokensNombre maximal de tokens par réponse
Keep AliveDurée pendant laquelle Ollama garde le modèle en mémoire (par exemple 5m, 24h). Utilise -1 pour une durée indéfinie.
En-têtes de proxyEn-têtes HTTP personnalisés facultatifs au format JSON, par exemple X-Ollama-Backend: llama-cpp

Injection de contexte

Mode de contexteChoisis comment injecter le contexte des entités : Direct (inclut toujours les entités indiquées) ou Vector DB (récupère dynamiquement les entités pertinentes)
Format du contexteFormat des données d'entités : JSON (structuré) ou Natural Language (lisible par un humain)
Entités à inclureListe d'identifiants d'entités ou de motifs séparés par des virgules (par exemple sensor.temperature, light.*, climate.thermostat)

Configuration de la base de données vectorielle

Hôte ChromaDBNom d'hôte ou adresse IP du serveur ChromaDB
Port ChromaDBPort du serveur ChromaDB
Nom de la collectionNom de la collection contenant les embeddings des entités
Fournisseur d'embeddingsChoisis entre OpenAI et Ollama pour générer les embeddings
URL de base de l'API d'embeddingsURL de base de l'API d'embeddings (par exemple localhost:11434 pour Ollama)
Modèle d'embeddingsNom du modèle (par exemple text-embedding-3-small pour OpenAI, mxbai-embed-large pour Ollama)
Clé d'API OpenAITa clé d'API OpenAI (nécessaire uniquement avec le fournisseur OpenAI)
Top K résultatsNombre d'entités les plus pertinentes à récupérer
Seuil de similaritéSeuil maximal de distance L2 (plus bas = correspondance plus stricte, plage habituelle : 150-300)

Historique des conversations

Activer l'historique des conversationsInclure les échanges précédents dans le contexte du LLM
Nombre maximal de messagesNombre maximal d'échanges de conversation à conserver (0 pour illimité)
Nombre maximal de tokensLimite de l'historique en tokens (0 pour illimité)
Conserver après les redémarragesEnregistre l'historique des conversations entre les redémarrages de Home Assistant

Prompt système

Utiliser le prompt système par défautUtilise le prompt système intégré de Home Agent, qui explique l'usage des outils et les consignes
Ajouts personnalisés au promptInstructions supplémentaires à ajouter à la fin du prompt système (par exemple préférences, règles de la maison)

Configuration des outils

Activer les outils natifsActive les outils ha_control et ha_query pour l'intégration avec Home Assistant
Nombre maximal d'appels d'outils par échangeNombre maximal d'exécutions d'outils par échange de conversation
Délai d'expiration des outils (secondes)Durée d'exécution maximale pour chaque appel d'outil

Outil LLM externe (facultatif)

Activer l'outil LLM externeExpose l'outil query_external_llm au LLM principal pour les analyses complexes et les explications détaillées
URL de base du LLM externePoint d'accès d'API compatible avec OpenAI pour le LLM externe
Clé d'API du LLM externeClé d'API pour l'authentification auprès du LLM externe
Modèle du LLM externeNom du modèle externe (par exemple gpt-4o, claude-3-opus)
Température du LLM externeTempérature des réponses du LLM externe
Nombre maximal de tokens du LLM externeNombre maximal de tokens pour les réponses du LLM externe
Inclure le contexte automatiquementTransmet automatiquement l'historique de la conversation et le contexte des entités au LLM externe

Réglages avancés

Activer la journalisation de débogageActive une journalisation détaillée pour le dépannage
Émettre des événementsDéclenche des événements Home Assistant pour le suivi des conversations et les déclencheurs d’automatisation

Après la mise en place

URL de base du LLMPoint de terminaison d’API compatible OpenAI (par exemple api.openai.com/v1 ou localhost:11434/v1 pour Ollama)
Clé d’APIClé d’API pour l’authentification
Nom du modèleModèle à utiliser (par exemple gpt-4o-mini, llama3.1)
Température
Nombre maximal de tokensNombre maximal de tokens par réponse
Keep AliveDurée pendant laquelle Ollama garde le modèle en mémoire (par exemple 5m, 24h). Utilise -1 pour une durée illimitée.
En-têtes du proxyEn-têtes HTTP personnalisés facultatifs au format JSON, par exemple X-Ollama-Backend: llama-cpp
Activer le mode réflexionPermet aux modèles de raisonnement d’utiliser une réflexion prolongée. Désactive cette option pour ajouter automatiquement /no_think aux prompts et obtenir des réponses plus rapides.
Mode de contexteChoisis comment injecter le contexte des entités
Format du contexteFormat des données d’entités (JSON, langage naturel ou hybride)
Entités à inclureListe d’ID d’entités séparés par des virgules (par exemple sensor.temperature,light.*)
Nombre maximal de tokens de contexteNombre total maximal de tokens pour le contexte (entités + historique + prompt). Augmente-le si ton modèle a une grande fenêtre de contexte. Par défaut : 8000.
Hôte ChromaDBNom d’hôte ou adresse IP du serveur ChromaDB
Port ChromaDBPort du serveur ChromaDB
Nom de la collectionNom de la collection contenant les embeddings des entités
Fournisseur d’embeddingsChoisis entre OpenAI et Ollama pour générer les embeddings
URL de base de l’API d’embeddingsURL de base de l’API d’embeddings (par exemple localhost:11434 pour Ollama)
Modèle d’embeddingsNom du modèle (par exemple text-embedding-3-small pour OpenAI, mxbai-embed-large pour Ollama)
Clé d’API OpenAITa clé d’API OpenAI (nécessaire uniquement avec le fournisseur OpenAI)
Top K résultatsNombre d’entités les plus pertinentes à récupérer
Seuil de similaritéSeuil maximal de distance L2 (plus bas = correspondance plus stricte, plage habituelle : 150-300)
Activer l’historique des conversationsInclut les échanges précédents dans le contexte du LLM
Nombre maximal de messagesNombre maximal d’échanges de conversation à conserver
Nombre maximal de tokensLimite de l’historique en tokens
Activer la persistance des sessions vocalesConserve le contexte de conversation entre plusieurs interactions vocales depuis le même appareil. Si cette option est désactivée, chaque requête vocale démarre une nouvelle conversation.
Délai d’expiration de la session (minutes)Durée en minutes avant que les sessions vocales expirent et repartent de zéro (1-120 minutes)
Utiliser le prompt système par défautUtilise le prompt système intégré de Home Agent
Inclure les étiquettes des entités et appareilsInclut les étiquettes des entités et des appareils dans le prompt système pour un meilleur contexte
Ajouts personnalisés au promptInstructions supplémentaires à ajouter à la fin du prompt système
Nombre maximal d’appels d’outils par échangeNombre maximal d’exécutions d’outils par échange de conversation
Délai d’expiration des outils (secondes)Durée d’exécution maximale de chaque appel d’outil
Activer l’outil LLM externeExpose l’outil query_external_llm au LLM principal
URL de base du LLM externePoint de terminaison d’API compatible OpenAI pour le LLM externe
Clé d’API du LLM externeClé d’API pour l’authentification auprès du LLM externe
Modèle du LLM externeNom du modèle externe
Température du LLM externeTempérature pour les réponses du LLM externe
Nombre maximal de tokens du LLM externeNombre maximal de tokens pour les réponses du LLM externe
Description de l’outilDescription des cas où utiliser le LLM externe
Inclure le contexte automatiquementTransmet automatiquement le contexte au LLM externe
Activer le système de mémoireInterrupteur de confidentialité : active ou désactive tout le système de mémoire
Activer l’extraction automatique des souvenirsExtrait automatiquement les souvenirs après chaque conversation
LLM pour l’extraction des souvenirsChoisis quel LLM utiliser pour extraire les souvenirs (le LLM externe est plus précis, mais il faut que External LLM soit activé)
Nombre maximal de souvenirs stockésNombre maximal de souvenirs à stocker (les plus anciens ou les moins importants sont supprimés quand la limite est atteinte)
Importance minimale (0.0-1.0)Filtre les souvenirs selon le score d’importance attribué par le LLM. Des valeurs basses (0.2-0.3) gardent la plupart des souvenirs, y compris les mentions occasionnelles. Des valeurs moyennes (0.4-0.5) écartent les détails mineurs. Des valeurs élevées (0.6-0.8) ne gardent que les préférences et les faits importants. La valeur par défaut de 0.4 offre un filtrage équilibré.
Nombre minimal de motsNombre minimal de mots significatifs (>2 caractères) requis pour qu’un souvenir soit stocké. Aide à écarter les souvenirs courts et de faible valeur.
Souvenirs à injecter dans le contexteNombre de souvenirs pertinents à inclure dans chaque conversation
Nom de la collection ChromaDBNom de la collection ChromaDB pour l’indexation des souvenirs

Textes issus du code de aradlein/hass-agent-llm. Les textes que le dépôt ne fournit pas en français ont été traduits automatiquement.

Actions

Réindexer les entitésForce une réindexation complète de toutes les entités Home Assistant dans la base de données vectorielle.
Indexer une entitéIndexe une entité précise dans la base de données vectorielle.Champs : ID de l’entité
Effacer la conversationEfface la session de conversation et repart de zéro, sans contexte précédent. Permet de réinitialiser les conversations vocales pour un utilisateur ou un appareil précis, ou toutes les conversations à la fois.

Extrait du README

A highly customizable Home Assistant custom component that provides intelligent conversational AI capabilities with advanced tool calling, context injection, and conversation history management.
LLM Integration - Works with OpenAI, Azure OpenAI, Ollama, LocalAI, LM Studio, or any OpenAI-compatible endpoint
Entity Context - Automatically provides relevant entity states to the LLM
Conversation History - Maintains context across multiple interactions with persistent storage
Native Tools - Built-in ha_control and ha_query tools for home automation
Custom Tools - Define REST API and Home Assistant service tools in configuration
Event System - Rich events for automation triggers and monitoring
Streaming Responses - Low-latency streaming for voice assistant integration (~10x faster)

Extrait du README de aradlein/hass-agent-llm, MIT License. Abrégé.

Informations

Installations: 172 partagent leurs statistiques
Étoiles GitHub: 48
Connexion: Utilise le cloud du fournisseur
Maintenance: Mise à jour au cours des 6 derniers mois
Version: v0.9.5, 11 mai 2026
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_agent
Source: github.com/aradlein/hass-agent-llm
Problèmes: Signaler un problème