Résoudre ComfyUI Manager qui ne reconnaît pas les Custom Nodes installés

Vous avez installé des custom nodes dans ComfyUI, ils sont bien là dans votre dossier custom_nodes, mais ComfyUI Manager les affiche obstinément comme "non installés". Vous cliquez sur installer à nouveau et cela crée des doublons. Ou vous essayez de mettre à jour mais il dit qu'il n'y a rien à mettre à jour alors que vous savez que de nouvelles versions existent.

Réponse rapide : ComfyUI Manager ne reconnaissant pas les nodes installés résulte généralement d'une désynchronisation de la base de données, de méthodes d'installation incorrectes ou de conflits de métadonnées en cache. La solution implique généralement de vider le cache de la base de données de nodes du Manager, de s'assurer que les nodes ont été installés via Manager plutôt que par git clone manuel, et de vérifier que la structure des dossiers correspond aux attentes du Manager. Un redémarrage du Manager ou une reconstruction de la base de données résout la plupart des cas en quelques minutes.

Ce problème fait partie des frustrations ComfyUI les plus courantes rapportées par les utilisateurs. C'est particulièrement agaçant car vos nodes fonctionnent parfaitement dans les workflows. Ils se chargent correctement, s'exécutent sans erreurs, mais Manager pense qu'ils n'existent pas. Corrigeons cela systématiquement.

Pourquoi ComfyUI Manager ne reconnaît-il pas les nodes ?

Comprendre la cause profonde vous aide à corriger cela correctement et à prévenir la récurrence.

Comment Manager suit les installations

ComfyUI Manager ne regarde pas simplement votre dossier custom_nodes. Il maintient une base de données interne qui suit ce qu'il a installé, d'où et quelle version. Cette base de données réside dans la structure de répertoires propre au Manager.

Lorsque vous clonez manuellement un dépôt de nodes avec git, le node fonctionne parce que ComfyUI lui-même scanne simplement les fichiers Python dans custom_nodes. Mais Manager n'en sait rien parce que rien n'a mis à jour la base de données du Manager.

L'inverse se produit également. Si la base de données du Manager dit que quelque chose est installé mais que le dossier a été supprimé ou déplacé, Manager l'affiche comme installé alors qu'il est en fait manquant.

Causes courantes de désynchronisation

Les opérations git manuelles sont la cause principale. Cloner, pull ou supprimer des dossiers de nodes sans passer par Manager brise son suivi.

Les installations échouées peuvent laisser des entrées partielles dans la base de données. Manager a essayé d'installer quelque chose, a échoué en cours de route, mais l'a enregistré comme installé avant l'échec.

Déplacer ou copier des installations ComfyUI laisse souvent la base de données du Manager pointant vers de mauvais chemins ou avec des informations obsolètes sur le système précédent.

Les mises à jour du Manager introduisent occasionnellement des changements de schéma de base de données. Les anciens formats de base de données peuvent ne pas être analysés correctement après la mise à jour du Manager lui-même.

L'interférence de l'antivirus supprime parfois des fichiers pendant l'installation mais après que Manager a enregistré l'installation comme terminée. Manager pense que cela a réussi mais les fichiers ont disparu.

La couche de cache

Manager met également en cache les métadonnées des nodes comme les mises à jour disponibles et les informations du dépôt. Ce cache peut devenir obsolète ou corrompu, affichant des statuts périmés ou incorrects même lorsque la base de données sous-jacente est correcte.

Les problèmes de cache causent des symptômes comme "mise à jour disponible" qui n'apparaît jamais, ou des numéros de version incorrects s'affichant dans l'interface du Manager.

Comment résoudre les problèmes de reconnaissance de nodes ?

Commencez par les solutions les plus simples et escaladez si nécessaire.

Solution 1 : Redémarrer ComfyUI complètement

Parfois Manager a juste besoin d'une nouvelle initialisation. Fermez ComfyUI complètement - pas juste rafraîchir, mais arrêter le processus Python.

Attendez quelques secondes pour que les handles de fichiers soient libérés, puis redémarrez ComfyUI. Manager se réinitialise au démarrage et peut détecter des nodes qu'il a manqués pendant une session de longue durée.

Cette étape simple résout le problème environ 20% du temps sans aucun risque.

Solution 2 : Forcer la reconstruction de la base de données du Manager

Manager a une fonction intégrée pour reconstruire sa base de données de nodes à partir de l'état du système de fichiers.

Ouvrez Manager dans ComfyUI en cliquant sur le bouton Manager. Naviguez vers les paramètres ou options avancées. Cherchez une option intitulée "Reconstruire la base de données" ou "Rescanner les nodes".

Cliquer dessus force Manager à scanner le répertoire custom_nodes à nouveau et reconstruire ses enregistrements d'installation. Tous les nodes présents seront détectés et enregistrés correctement.

Après la reconstruction, redémarrez ComfyUI pour que les changements prennent pleinement effet.

Solution 3 : Vider le cache de la base de données de nodes

Si la reconstruction n'aide pas, videz les fichiers de cache manuellement. Naviguez vers votre répertoire d'installation ComfyUI.

Trouvez le dossier ComfyUI-Manager dans custom_nodes. Dans le dossier du Manager, cherchez des fichiers nommés comme node_db.json, cache.json, ou des fichiers de base de données similaires.

Supprimez ces fichiers de cache. Ne vous inquiétez pas, ils seront recréés automatiquement quand Manager redémarrera. La nouvelle base de données reflétera précisément vos installations actuelles.

Redémarrez ComfyUI après avoir supprimé les fichiers de cache. Manager prendra un peu plus de temps au premier chargement car il reconstruit tout de zéro.

Solution 4 : Réinstaller les nodes problématiques via Manager

Pour les nodes que vous avez clonés manuellement, la solution la plus propre est de réinstaller via Manager.

D'abord, supprimez le dossier cloné manuellement de custom_nodes. Ne le renommez pas simplement car cela peut causer d'autres problèmes.

Ensuite utilisez l'interface d'installation de Custom Nodes du Manager pour installer le même node. Manager le clonera correctement et l'enregistrera dans sa base de données.

Cette approche assure que Manager a un suivi complet et peut gérer les mises à jour, dépendances et suppressions correctement à l'avenir.

Solution 5 : Vérifier les noms de dossiers

Manager attend des noms de dossiers spécifiques correspondant aux noms de dépôts. Si vous avez renommé un dossier de node, Manager ne peut pas le faire correspondre à son entrée de base de données.

Vérifiez que les noms de dossiers correspondent à ce que Manager attend. Le dépôt ComfyUI-Impact-Pack devrait avoir un dossier nommé exactement ComfyUI-Impact-Pack, pas Impact-Pack ou quoi que ce soit d'abrégé.

Si vous avez renommé des dossiers, soit renommez-les en arrière soit réinstallez via Manager pour obtenir les noms corrects automatiquement.

Solution 6 : Vérifier le statut du dépôt Git

Manager utilise git pour suivre les versions et mises à jour. Si le dossier .git dans un node est manquant ou corrompu, Manager ne peut pas déterminer le statut d'installation.

Naviguez dans le dossier d'un node problématique et vérifiez la présence d'un répertoire .git. S'il est manquant, le node ne sera pas correctement suivi.

Vous pouvez essayer d'exécuter git init suivi de la configuration du remote vers le dépôt original, mais réinstaller via Manager est généralement plus simple.

Solution 7 : Vérifier les installations en double

Parfois le même node est installé deux fois avec de légères variations de nom. Manager pourrait suivre l'un tandis que ComfyUI charge l'autre.

Recherchez des doublons dans votre dossier custom_nodes. Cherchez des dossiers avec des noms similaires ou une fonctionnalité de node identique. Supprimez les doublons, en ne gardant que celui installé via Manager.

Les modèles courants de doublons incluent avoir à la fois le nom original du dépôt et une version renommée, ou à la fois une branche de release et une branche de développement du même node.

Que faire si les nodes affichent des numéros de version incorrects ?

Les problèmes de détection de version sont liés mais distincts de la détection d'installation.

Mécanisme de suivi des versions

Manager vérifie les tags et commits git pour déterminer les versions. Si un dépôt de node n'utilise pas de versioning approprié, Manager affiche des versions "inconnues" ou incorrectes.

Ce n'est pas quelque chose que vous pouvez corriger pour des nodes que vous n'avez pas créés. Le développeur du node doit utiliser les tags git correctement.

Obsolescence du cache

Plus communément, les versions incorrectes résultent de métadonnées en cache. Videz le cache du Manager comme décrit ci-dessus pour forcer des vérifications de version fraîches.

Après avoir vidé le cache, Manager récupère le statut actuel du dépôt depuis GitHub ou GitLab. Cela prend un moment mais fournit des informations de version précises.

Problèmes de réseau

Si Manager ne peut pas atteindre les hôtes de dépôts, il affiche des versions obsolètes. Vérifiez votre connectivité réseau et toute règle de pare-feu bloquant les opérations git.

Les réseaux d'entreprise bloquent souvent les protocoles git. Si vous êtes sur un réseau restreint, Manager ne peut pas mettre à jour sa connaissance des versions disponibles.

Comment prévenir ce problème à l'avenir ?

Les bonnes pratiques gardent Manager et vos nodes synchronisés en permanence.

Toujours installer via Manager

Même quand vous avez une URL GitHub et connaissez git, utilisez l'interface du Manager. Collez l'URL dans le champ d'installation personnalisée du Manager plutôt que de cloner manuellement.

Cela assure un enregistrement approprié dans la base de données dès le départ. Le clonage manuel ne devrait se faire que lors du débogage ou du développement de nodes.

Utiliser Manager pour les mises à jour

Quand des nodes ont des mises à jour disponibles, utilisez la fonction de mise à jour du Manager plutôt que d'exécuter git pull vous-même.

La mise à jour du Manager gère les mises à jour de dépendances, le suivi de version de la base de données, et les hooks post-mise à jour que les pulls manuels omettent.

Éviter la manipulation directe des dossiers

Ne supprimez, renommez ou déplacez pas manuellement les dossiers de nodes. Utilisez la fonction de désinstallation du Manager pour supprimer les nodes proprement.

Si vous devez manipuler des dossiers directement, attendez-vous à devoir reconstruire la base de données du Manager après.

Mises à jour régulières du Manager

Gardez Manager lui-même à jour. Les versions plus récentes corrigent les bugs de gestion de base de données et améliorent la détection de nodes.

Mettez à jour Manager en premier lors du dépannage de problèmes de nodes puisque la correction peut déjà exister dans une version plus récente du Manager.

Pour les utilisateurs qui veulent les capacités de ComfyUI sans gérer ces détails techniques, Apatero.com fournit une infrastructure maintenue professionnellement. Les nodes sont toujours correctement installés, mis à jour et configurés sans aucun de ces maux de tête de synchronisation.

Qu'en est-il des problèmes de reconnaissance de nodes spécifiques ?

Certains nodes ont des problèmes de reconnaissance uniques qui méritent d'être abordés spécifiquement.

Reconnaissance d'Impact Pack

ComfyUI-Impact-Pack est complexe avec de nombreuses dépendances. Les problèmes de reconnaissance proviennent souvent de problèmes de sous-modules.

Assurez-vous que le dossier impact_pack_models existe et contient les fichiers requis. Impact Pack ne s'affichera pas comme correctement installé si ses fichiers de modèle sont manquants même si le code est présent.

Utilisez l'installateur intégré d'Impact Pack pour ses dépendances plutôt que l'installation générique du Manager. Cela gère les fichiers de modèle correctement.

Problèmes du préprocesseur ControlNet

ComfyUI-ControlNet-AUX nécessite des téléchargements de modèles après installation. Manager le marque comme installé immédiatement, mais il n'est pas vraiment prêt tant que les modèles ne sont pas téléchargés.

Si les nodes de prétraitement donnent des erreurs, exécutez les scripts de téléchargement de modèles ou laissez-les se télécharger à la première utilisation. Le node est installé selon Manager, juste incomplet.

Reconnaissance de Video Helper Suite

VideoHelperSuite a des dépendances ffmpeg spécifiques qui affectent la reconnaissance. Si ffmpeg n'est pas correctement accessible, Manager peut afficher un statut d'installation partiel.

Vérifiez que ffmpeg est dans votre PATH système et accessible depuis la ligne de commande. Puis reconstruisez la base de données du Manager.

Questions fréquemment posées

Pourquoi Manager affiche-t-il "Mise à jour" pour un node que je viens d'installer ?

Cela se produit quand vous avez installé depuis une branche de développement mais Manager vérifie la branche principale pour les mises à jour. Les numéros de version ne correspondent pas, donc Manager voit une mise à jour disponible. C'est généralement sûr d'ignorer ou vous pouvez mettre à jour pour synchroniser avec la branche principale.

Puis-je utiliser à la fois Manager et les clones git manuels ensemble ?

Techniquement oui, mais les clones manuels n'apparaîtront pas dans l'interface du Manager. Ils fonctionneront dans ComfyUI mais Manager ne les suivra pas. Pour l'expérience la plus propre, choisissez une méthode et tenez-vous-y.

La reconstruction de la base de données cassera-t-elle mes workflows ?

Non, la reconstruction de la base de données n'affecte que le suivi du Manager. Vos workflows, prompts sauvegardés et configurations de nodes restent intacts. Tout fonctionnera exactement comme avant, juste avec un statut Manager précis.

Pourquoi certains nodes apparaissent-ils plusieurs fois dans la liste du Manager ?

Cela indique plusieurs installations, souvent provenant de tentatives d'installation échouées qui ont laissé des entrées partielles dans la base de données. Videz la base de données, supprimez toutes les copies du node en double, puis réinstallez une fois via Manager.

Comment savoir si un node a été installé via Manager ou manuellement ?

Les nodes installés par Manager apparaissent dans la liste des Nodes Installés avec des informations de version et mise à jour appropriées. Les nodes clonés manuellement soit n'apparaissent pas du tout soit affichent une version "Inconnue" sans capacité de mise à jour.

Cela affecte-t-il ma capacité à utiliser les nodes dans les workflows ?

Non, les problèmes de reconnaissance de nodes sont purement un problème du Manager. ComfyUI lui-même scanne le dossier custom_nodes indépendamment et charge ce qu'il trouve. Vos workflows fonctionneront indépendamment du statut de reconnaissance du Manager.

Pourquoi Manager dit-il "aucun node installé" quand j'en ai des dizaines ?

Cela indique une corruption ou perte complète de la base de données. Vos nodes sont corrects et fonctionnent. Videz complètement les fichiers de cache du Manager et reconstruisez la base de données de zéro. Tout sera détecté.

Puis-je sauvegarder la base de données du Manager avant le dépannage ?

Oui, copiez les fichiers json du dossier du Manager avant de les supprimer. Si quelque chose tourne mal vous pouvez les restaurer. Cependant, puisque ces fichiers sont exactement ce que vous dépannez, les restaurer restaurerait aussi le problème.

Que faire si le même problème continue de se reproduire ?

Les problèmes récurrents indiquent généralement un problème de workflow comme réinstaller des nodes manuellement entre les reconstructions du Manager. Vérifiez vos habitudes et assurez-vous que vous utilisez Manager de manière cohérente pour toutes les opérations de nodes.

Devrais-je signaler les bugs de reconnaissance au GitHub du Manager ?

Si vous avez essayé toutes les solutions et le problème persiste, oui. Incluez votre version de ComfyUI, version du Manager, système d'exploitation, et nodes spécifiques affectés. Les développeurs peuvent identifier s'il s'agit d'un bug connu ou d'un nouveau problème.

Conclusion et stratégie de prévention

Les problèmes de reconnaissance de nodes de ComfyUI Manager proviennent presque entièrement de la désynchronisation entre sa base de données et votre système de fichiers actuel. La solution est simple puisque vous devez forcer la synchronisation par la reconstruction de la base de données et le vidage du cache.

Commencez par un simple redémarrage. Si cela ne fonctionne pas, reconstruisez la base de données. Pour les problèmes persistants, videz tous les fichiers de cache et laissez Manager les recréer à neuf.

À l'avenir, engagez-vous à utiliser Manager pour toutes les opérations de nodes. Installez via Manager, mettez à jour via Manager, et supprimez via Manager. Cela garde tout synchronisé en permanence.

Les quelques minutes passées à dépanner maintenant économisent des heures de frustration future. Une fois que la base de données de votre Manager reflète précisément vos installations, les mises à jour fonctionnent en douceur, les dépendances se résolvent correctement, et vous pouvez faire confiance aux indicateurs de statut du Manager.

Pour les utilisateurs qui préfèrent ne pas gérer ces tâches de gestion technique, Apatero.com gère automatiquement toute l'installation et la maintenance des nodes. Vous obtenez l'accès à des nodes correctement configurés sans soucis de synchronisation de base de données ou dépannage manuel.

Gardez Manager à jour, utilisez-le de manière cohérente, et ces problèmes de reconnaissance appartiendront au passé.