Déploiement en add-on sur Home Assistant OS
Les utilisateurs de Home Assistant OS ou HA Supervised peuvent installer SkyView en un clic sous forme d'add-on. SkyView propose deux add-ons : yunkan (version CPU générique) et yunkan-openvino (version accélérée par iGPU Intel).
1. Portée
Architecture amd64 uniquement
| Add-on | Matériel adapté | Vitesse d'inférence |
|---|---|---|
| yunkan | Tout hôte HA OS amd64 | CPU uniquement |
| yunkan-openvino | CPU Intel + iGPU (11e génération et plus Iris Xe / N100 / N305) | Accéléré par iGPU, recommandé |
N'en installer qu'un seul
2. Ajouter le dépôt SkyView
Recommandé : redirection en un clic. Ouvrez cette page sur un appareil pouvant atteindre HA et cliquez sur le badge ci-dessous ; my.home-assistant.io retrouve automatiquement votre HA et préremplit l'URL du dépôt — il ne reste qu'à confirmer.
Le premier clic demande l'adresse de votre HA (par ex. http://homeassistant.local:8123) et s'en souvient ensuite. Si la redirection échoue ou que vous n'avez pas l'intégration My Home Assistant installée, utilisez la méthode manuelle ci-dessous.
Méthode manuelle :
- 1
Ouvrir le magasin d'add-ons
Interface web HA → Paramètres → Add-ons → Magasin d'add-ons
- 2
Ajouter un dépôt personnalisé
Menu à trois points en haut à droite → Dépôts → collez l'URL ci-dessous → Ajouter
- 3
Coller cette URL
L'adresse complète ci-dessous, à copier-coller directement :
https://github.com/mrtian2016/yunkan-hassio-addonsUne fois ajouté, la page se rafraîchit et une section « Yunkan » apparaît en bas du magasin d'add-ons avec deux cartes, yunkan et yunkan-openvino.
3. Installer et démarrer
- 1
Choisir une variante
Cliquez sur
yunkan-openvinosur les machines Intel,yunkansinon - 2
Installer
Le bouton « Install » en bas à droite ; attendez la fin du téléchargement (image d'environ 700 Mo, quelques minutes la première fois)
- 3
Configurer (facultatif)
Onglet « Configuration » : les valeurs par défaut conviennent ; n'ajustez ici que pour des besoins particuliers (ports personnalisés, fuseau horaire)
- 4
Démarrer
Onglet « Info » → bouton « Start »
- 5
Activer le démarrage automatique + Watchdog
Activez les deux options ci-dessous : « Start on boot » + « Watchdog » ; garantit que l'add-on redémarre automatiquement si l'hôte HA redémarre ou si l'add-on plante
- 6
Ouvrir l'interface web
Une entrée « SkyView » apparaît dans la barre latérale (ou visitez
http://<IP hôte HA>:23406/) pour accéder à l'assistant de configuration
4. Persistance des données
Les données de l'add-on vont automatiquement dans le répertoire /share/yunkan/ de HA (enregistrements, base de données, modèles et cookies 115, tout y est). Ce répertoire :
- Est inclus dans les sauvegardes HA OS — une sauvegarde complète via Supervisor → Backups inclut
/share/, donc les données SkyView sont incluses - Est accessible via SMB externe — l'add-on Samba par défaut de HA mappe
/share/, vous pouvez donc parcourir les fichiers d'enregistrement depuis un PC/NAS - Survit aux mises à jour — une mise à jour de l'add-on ne fait que remplacer l'image ; les données persistantes dans /share sont conservées
5. Mise à jour
Le module complémentaire YunKan suit le flux de mise à jour standard des add-ons HA : HA vous notifie quand une nouvelle version est disponible (toast en bas à droite + Paramètres → Modules complémentaires → ce module → bandeau jaune en haut) ; cliquez simplement sur « Mettre à jour ». La console web YunKan détecte automatiquement l'environnement add-on et affiche les instructions adaptées — aucun composant de mise à niveau supplémentaire n'est requis.
6. FAQ
Mon HA tourne sur un Raspberry Pi — que faire ?
L'accélération iGPU ne fonctionne pas (variante yunkan-openvino)
devices: [/dev/dri:/dev/dri:rwm], le passthrough devrait donc être automatique. Causes d'échec courantes : l'hôte n'a pas d'iGPU (vérifiez HA Supervisor → Host system → si le CPU est Intel), ou le noyau HA OS ne prend pas en charge l'iGPU de la machine. Revenir à la variante yunkan (CPU) fonctionne toujours.Ne pas installer par-dessus lors d'un changement de variante