m81098s/claude-skill-homeassistant

Que fait claude-skill-homeassistant ?

🛠️ Gérez Home Assistant sans effort avec Claude pour une configuration simplifiée, un accès distant et la création de tableaux de bord personnalisés.

---

Introduction

Cette compétence permet à Claude d'interagir directement avec votre instance Home Assistant, vous offrant un contrôle vocal et textuel de vos appareils domestiques intelligents. Vous pouvez utiliser des commandes en langage naturel pour allumer les lumières, ajuster les thermostats, créer des automatisations complexes et bien plus encore.

Fonctionnalités

• Configuration simplifiée : Modifiez les fichiers de configuration YAML sans ouvrir l'éditeur web.
• Accès distant sécurisé : Utilisez Claude pour configurer un accès via VPN, Tailscale, ou un tunnel sécurisé.
• Tableaux de bord personnalisés : Créez et personnalisez des tableaux de bord Lovelace avec des instructions simples.
• Automatisation : Gérez les scripts et les automations depuis votre terminal.

Prérequis

Avant d'utiliser cette compétence, assurez-vous d'avoir :

• Une instance Home Assistant fonctionnelle (version 2021.5 ou ultérieure recommandée).
• Un token d'accès longue durée pour l'API REST (créer un token ici).
• Claude intégré dans votre environnement de développement (CLI, Cursor, Codex, etc.).

Configuration

1. Variables d'environnement :

   export HOME_ASSISTANT_URL="http://homeassistant:8123"
   export HOME_ASSISTANT_TOKEN="votre_token_longue_duree"
   

2. Vérification de la connexion :

   curl -H "Authorization: Bearer $HOME_ASSISTANT_TOKEN" -H "Content-Type: application/json" $HOME_ASSISTANT_URL/api/
   

3. Installation de la compétence (selon votre plateforme) :

   • Pour Claude Code : claude add-skill m81098s/claude-skill-homeassistant
   • Pour Cursor : Collez le fichier SKILL.md dans le répertoire .cursor/skills/.

Utilisation

Exemples de commandes

• Allumer/éteindre des lumières :

  claude "Allume la lumière du salon"
  

• Créer une automatisation :

  claude "Crée une automatisation qui allume les lumières extérieures au coucher du soleil"
  

• Afficher l'état d'un capteur :

  claude "Quelle est la température dans la chambre ?"
  

Exemple de script

import requests

url = "$HOME_ASSISTANT_URL/api/services/light/turn_on"
headers = {
    "Authorization": "Bearer $HOME_ASSISTANT_TOKEN",
    "Content-Type": "application/json"
}
data = {"entity_id": "light.living_room"}
response = requests.post(url, headers=headers, json=data)
print(response.json())

Dépannage

Problème	Solution
401 Unauthorized	Vérifiez que votre token d'accès est valide et non expiré.
Connection refused	Assurez-vous que l'URL de Home Assistant est accessible depuis le réseau de Claude.
Les commandes ne sont pas reconnues	Vérifiez que la compétence est bien installée et activée.

Contribuer

Les contributions sont les bienvenues ! Visitez le dépôt GitHub pour signaler des bugs ou proposer des fonctionnalités.

Licence

MIT