ComfyUI Manager : installer des nodes, réparer les erreurs

#À quoi sert ComfyUI Manager

ComfyUI ne sait faire, de base, que ce que ses nœuds intégrés permettent. Tout le reste, ControlNet avancé, préprocesseurs, agrandisseurs, outils vidéo, nœuds de confort, vient d'extensions appelées custom nodes. Chaque custom node est un dépôt Git contenant du code Python, déposé dans le dossier custom_nodes de votre installation et chargé au démarrage.

Sans Manager, installer une extension revient à cloner un dépôt à la main, installer ses dépendances Python dans le bon environnement, puis redémarrer. Le Manager fait ces étapes depuis une fenêtre de l'interface. Il apporte surtout trois fonctions que l'on finit toujours par utiliser : la détection des nodes qui manquent à un workflow, un bouton de réparation pour les nodes qui refusent de se charger, et des instantanés pour revenir en arrière après une mise à jour malheureuse.

Custom Nodes Manager

Le catalogue : recherche, installation, mise à jour, désactivation et désinstallation des extensions référencées.

Install Missing Custom Nodes

Analyse le workflow ouvert et liste les extensions absentes qui expliquent les nœuds rouges.

Model Manager

Télécharge des modèles connus directement dans le bon sous-dossier de models.

Update All

Met à jour toutes les extensions installées en une fois. Pratique, mais c'est aussi la commande qui casse le plus souvent une installation qui marchait.

Snapshot Manager

Enregistre l'état de l'installation (version de ComfyUI, extensions, paquets Python) pour pouvoir y revenir.

#Prérequis : savoir où est votre dossier custom_nodes

Le Manager, comme toute extension, vit dans le dossier custom_nodes. Son emplacement dépend de la façon dont vous avez installé ComfyUI, et la moitié des problèmes de « node installé mais absent » viennent d'une extension placée dans le mauvais dossier ou de dépendances installées dans le mauvais Python.

ComfyUI Desktop

Le dossier de base est celui que vous avez choisi à l'installation (souvent un dossier ComfyUI dans vos Documents). Il contient custom_nodes, models, input et output. L'environnement Python est géré par l'application, dans un dossier .venv à côté.

Version portable Windows

Dans l'archive décompressée : ComfyUI_windows_portable/ComfyUI/custom_nodes. Le Python dédié est ComfyUI_windows_portable/python_embeded, et c'est lui qu'il faut utiliser pour installer des dépendances, jamais le Python du système.

Installation manuelle (git clone)

ComfyUI/custom_nodes, avec l'environnement virtuel que vous avez créé pour ComfyUI. Activez-le avant toute commande pip.

Dans tous les cas

Git doit être installé et accessible : le Manager clone les dépôts avec lui. Sur Windows, vérifiez avec git --version dans un terminal.

Si ComfyUI n'est pas encore installé, commencez par le guide d'installation de ComfyUI, qui compare Desktop, portable et installation manuelle. Ce guide-ci suppose une installation qui génère déjà une image.

#Installer ComfyUI Manager selon votre version

Il existe trois situations, et la première est la plus fréquente en 2026 : le Manager est déjà là. Vérifiez d'abord la présence d'un bouton Manager dans la barre supérieure de l'interface avant d'installer quoi que ce soit.

#Cas 1 : il est déjà inclus (Desktop, comfy-cli)

L'application ComfyUI Desktop embarque le Manager. Il en va de même pour une installation réalisée avec l'outil en ligne de commande comfy-cli, qui l'ajoute par défaut. Si le bouton Manager apparaît en haut de l'interface, vous n'avez rien à faire : passez à la section suivante.

#Cas 2 : ComfyUI récent, Manager intégré mais désactivé

Le dépôt principal de ComfyUI intègre désormais le Manager sous forme de dépendance facultative. Il ne s'active pas tout seul : il faut installer le fichier manager_requirements.txt présent à la racine de ComfyUI, puis lancer le serveur avec l'option --enable-manager. C'est le chemin à privilégier pour une installation manuelle récente, car le Manager suit alors la version attendue par votre ComfyUI.

cd ComfyUI
pip install -r manager_requirements.txt
python main.py --enable-manager

Pour ne pas retaper l'option à chaque fois, ajoutez-la à votre script de lancement ou à votre service. Sur la version portable, elle se place à la fin de la ligne de commande du fichier run_nvidia_gpu.bat (ou de son équivalent AMD ou Intel).

#Cas 3 : installation classique dans custom_nodes

C'est la méthode historique, toujours documentée dans le dépôt du Manager, et la seule possible sur une version de ComfyUI qui n'a pas le fichier manager_requirements.txt. On clone le dépôt dans custom_nodes, puis on redémarre ComfyUI complètement.

cd ComfyUI/custom_nodes
git clone https://github.com/Comfy-Org/ComfyUI-Manager.git
# puis arrêter ComfyUI (Ctrl+C) et le relancer
cd ..
python main.py

cd ComfyUI\custom_nodes
git clone https://github.com/Comfy-Org/ComfyUI-Manager.git
cd ..\..
.\python_embeded\python.exe -m pip install -r ComfyUI\custom_nodes\ComfyUI-Manager\requirements.txt
# puis relancer run_nvidia_gpu.bat

Au redémarrage, lisez le terminal. Une ligne mentionnant ComfyUI-Manager suivie de son numéro de version confirme le chargement. Si vous voyez à la place IMPORT FAILED en face de son nom, les dépendances n'ont pas été installées dans le bon Python : reprenez la commande pip avec l'environnement de ComfyUI.

#Ajouter un custom node avec le Manager

1. 01
   Ouvrir le catalogue

   Cliquez sur Manager dans la barre supérieure, puis sur Custom Nodes Manager. La première ouverture télécharge la liste des extensions référencées, ce qui peut prendre quelques secondes.
2. 02
   Chercher l'extension

   Tapez son nom ou un mot-clé dans le champ de recherche. Les colonnes indiquent l'auteur, la description, le nombre d'étoiles GitHub et, selon les versions, la date de dernière mise à jour. Vérifiez que l'auteur correspond bien au dépôt que l'on vous a recommandé : les noms proches sont fréquents.
3. 03
   Installer

   Cliquez sur Install. Le Manager clone le dépôt dans custom_nodes et installe les dépendances listées dans son requirements.txt. Le terminal défile pendant l'opération. Si l'extension existe sur le Comfy Registry, le Manager propose en général une version publiée et numérotée plutôt que la dernière révision Git : prenez la version publiée, plus stable.
4. 04
   Redémarrer

   Un bandeau vous invite à redémarrer. Acceptez. ComfyUI se relance, recharge toutes les extensions et le navigateur se reconnecte. Rafraîchissez la page si l'interface ne revient pas d'elle-même.
5. 05
   Vérifier

   Double-cliquez sur le canevas et tapez le nom d'un nœud de l'extension. S'il apparaît dans la liste, c'est terminé. Sinon, lisez la section sur les nodes installés mais absents.

Pour les scripts et les installations sans interface, comfy-cli couvre le même besoin en ligne de commande : comfy node install suivi du nom de l'extension l'installe dans l'installation ComfyUI active. Le Manager et comfy-cli lisent le même dossier custom_nodes, vous pouvez mélanger les deux.

#Nodes manquants : le workflow s'ouvre avec des nœuds rouges

C'est le cas d'usage numéro un du Manager. Vous chargez un workflow trouvé en ligne ou extrait d'une image, et ComfyUI affiche une fenêtre listant des types de nœuds manquants, avec des blocs rouges sur le canevas. Le workflow utilise des extensions que vous n'avez pas.

1. 01
   Lire la liste des types manquants

   La fenêtre d'avertissement donne les noms internes des nœuds. Notez-les : ils aident à retrouver l'extension si la détection automatique échoue.
2. 02
   Lancer Install Missing Custom Nodes

   Dans le menu Manager, ce bouton croise les nœuds manquants avec la base des extensions connues et affiche celles qui les fournissent. Cochez-les et installez.
3. 03
   Redémarrer et recharger le workflow

   Après le redémarrage, rouvrez le fichier du workflow (ou glissez de nouveau l'image). Les nœuds rouges doivent avoir repris leur couleur normale.
4. 04
   Traiter les restes à la main

   Si un nœud reste manquant, la détection n'a pas trouvé son extension : elle n'est pas référencée, a changé de nom, ou le nœud a été renommé par son auteur. Cherchez le nom interne du nœud sur le dépôt ou le forum d'où vient le workflow, puis installez l'extension par son nom dans le catalogue.

Deux pièges reviennent souvent. Le premier : un workflow qui demande une extension introuvable partout ailleurs que sur un lien de téléchargement direct. Traitez-le avec méfiance, c'est le schéma des nœuds piégés décrits plus bas. Le second : un nœud manquant qui appartient en fait à ComfyUI lui-même, parce que votre version est trop ancienne. Dans ce cas, la solution est de mettre à jour ComfyUI, pas d'installer quoi que ce soit.

#Node installé mais absent : IMPORT FAILED, désactivé, mauvais dossier

L'extension apparaît comme installée dans le Manager, mais ses nœuds n'existent pas dans l'interface. Le diagnostic se fait dans le terminal au démarrage de ComfyUI : chaque extension y est listée avec son temps de chargement, et celles qui échouent portent la mention IMPORT FAILED suivie d'une trace Python. Cette trace est la seule information utile ; copiez-la avant de chercher de l'aide.

IMPORT FAILED avec ModuleNotFoundError

Une dépendance Python manque. Dans le Custom Nodes Manager, filtrez sur Import Failed et cliquez sur Try fix : le Manager réinstalle les dépendances de l'extension. Si cela échoue, installez le requirements.txt de l'extension à la main, avec le Python de ComfyUI (python_embeded sur la portable).

IMPORT FAILED avec une erreur de version

L'extension exige une version d'un paquet (souvent torch, numpy, transformers) incompatible avec une autre extension ou avec ComfyUI. Il faut arbitrer : lire les issues du dépôt, désactiver l'extension la moins utile, ou attendre un correctif. Ne forcez pas une version de torch, vous casseriez ComfyUI.

Extension désactivée

Le Manager désactive une extension en ajoutant le suffixe .disabled au nom de son dossier. ComfyUI l'ignore alors complètement. Filtrez sur Disabled dans le catalogue pour la réactiver, ou retirez le suffixe à la main.

Mauvais dossier

Vous avez deux installations (Desktop et portable, ou deux clones), et l'extension est dans le custom_nodes de l'autre. Le chemin exact du dossier chargé s'affiche dans les premières lignes du terminal au démarrage.

Dépôt vide ou tronqué

Un clone interrompu laisse un dossier sans code. Supprimez le dossier de l'extension et réinstallez-la.

Quand ComfyUI lui-même ne démarre plus ou que l'interface devient instable après une installation, la documentation de dépannage officielle recommande d'isoler le coupable par dichotomie. Lancez d'abord ComfyUI sans aucune extension pour confirmer que le problème vient bien d'un custom node.

python main.py --disable-all-custom-nodes

Si tout fonctionne ainsi, déplacez la moitié des dossiers de custom_nodes vers un dossier de côté, relancez, et recommencez avec la moitié restante jusqu'à isoler l'extension fautive. Avec dix extensions, quatre redémarrages suffisent. Désinstallez-la ensuite depuis le Manager et signalez le problème sur son dépôt avec la trace du terminal.

#Erreurs de registre : la liste des nodes ne se charge pas

Le Manager ne stocke pas le catalogue chez vous : à l'ouverture, il télécharge une liste d'extensions depuis le dépôt du Manager et, pour les extensions publiées, interroge le Comfy Registry, le dépôt officiel de Comfy Org où les auteurs publient des versions numérotées. Quand cette récupération échoue, le catalogue reste vide, l'installation d'un node tourne sans fin ou un message signale un échec de chargement de la liste.

Pas d'accès réseau depuis le serveur

Le Manager télécharge depuis la machine qui exécute ComfyUI, pas depuis votre navigateur. Sur un serveur distant ou un conteneur, vérifiez que celui-ci sort sur Internet (proxy, pare-feu, DNS). Un test curl vers github.com depuis cette machine lève le doute.

Mode de base de données

Dans la fenêtre du Manager, un sélecteur DB permet de passer du canal distant à une copie locale de la liste. Le mode local permet de continuer à travailler avec les extensions déjà connues quand GitHub est inaccessible ; il ne verra pas les extensions ajoutées depuis.

Canal

Le Manager propose plusieurs canaux de listes (default, recent, legacy, dev, entre autres). Si une extension n'apparaît pas, revenez au canal default avant de chercher plus loin ; les autres canaux servent aux extensions anciennes ou expérimentales.

Limites d'API GitHub

Après de nombreuses requêtes, GitHub peut refuser temporairement les appels anonymes. Attendez quelques minutes plutôt que de relancer en boucle.

Action refusée par le niveau de sécurité

Si le Manager répond qu'une action n'est pas permise avec le niveau de sécurité actuel, ce n'est pas une erreur réseau : lisez la section suivante.

Dernier recours, toujours valable : l'installation manuelle par git clone dans custom_nodes, suivie du requirements.txt et d'un redémarrage. Le Manager reconnaît ensuite l'extension comme installée et saura la mettre à jour.

#Repérer une extension risquée avant de l'activer

Un custom node est du code Python exécuté au démarrage de ComfyUI, avec les droits de l'utilisateur qui lance le serveur : il peut lire vos fichiers, vos jetons de session de navigateur, vos portefeuilles, et appeler Internet. Ce n'est pas théorique. En janvier 2026, le dépôt officiel de ComfyUI a documenté une série de nœuds publiés sur le Comfy Registry sous le nom « Upscaler_4K », qui installaient un voleur de données ciblant navigateurs, portefeuilles de cryptomonnaies et jetons Discord. En avril 2026, une campagne décrite par Censys visait les instances ComfyUI exposées sur Internet en exploitant des custom nodes qui exécutent du code sans authentification.

Le Manager intègre un garde-fou : un niveau de sécurité, réglé par la clé security_level de son fichier config.ini. Le dépôt du Manager documente quatre valeurs, strong, normal (valeur par défaut), normal- et weak. Le niveau par défaut bloque les actions les plus risquées, comme l'installation depuis une URL Git arbitraire ou l'installation de paquets pip à la demande, et les restrictions se durcissent quand ComfyUI est lancé avec --listen sur une adresse non locale. Le niveau weak lève toutes les barrières : ne l'activez que le temps d'une opération précise, sur une machine qui n'écoute pas sur le réseau, puis revenez à normal. La grille exacte des actions autorisées par niveau figure dans le README du Manager, qui fait foi en cas de doute.

Passer par le catalogue, pas par un lien

Les extensions du catalogue et du Registry sont au moins identifiées et peuvent être retirées en cas de signalement. Un lien de téléchargement direct ou un dépôt sans historique ne l'est pas.

Regarder l'auteur, l'historique et les étoiles

Un dépôt créé la semaine dernière, avec deux commits, aucune issue et un nom qui imite une extension connue est le profil type d'un nœud piégé. Les étoiles ne prouvent rien seules, mais une extension réellement utilisée en a, et des issues ouvertes.

Se méfier des promesses

Agrandisseur miraculeux, modèle commercial « débridé », workflow qui exige une seule extension introuvable ailleurs : refusez par défaut.

Lire le requirements.txt

Avant d'installer une extension inconnue, ouvrez son dépôt et lisez la liste des dépendances. Des paquets sans rapport avec l'image (accès navigateur, réseau bas niveau, compression d'archives exotiques) sont un signal d'alerte.

Ne jamais exposer ComfyUI sans protection

Sans --listen, ComfyUI n'écoute que sur 127.0.0.1. Si vous devez l'ouvrir sur le réseau, placez un reverse proxy avec mot de passe ou un VPN devant, et gardez security_level à normal.

#Mettre à jour sans tout casser

La mise à jour est la deuxième source de pannes après l'installation. ComfyUI évolue vite, les extensions suivent avec retard, et Update All applique tout d'un coup. Trois habitudes évitent de perdre une matinée.

1. 01
   Prendre un instantané avant

   Snapshot Manager, puis Save snapshot. Le Manager enregistre la révision de ComfyUI, celle de chaque extension et la liste des paquets Python dans son dossier snapshots. Si la mise à jour casse un workflow, Restore ramène l'ensemble à cet état après redémarrage.
2. 02
   Mettre à jour une extension à la fois

   Dans le catalogue, filtrez sur Update et mettez à jour d'abord l'extension dont vous avez besoin. Testez le workflow concerné. Update All reste utile sur une installation simple, mais après un instantané.
3. 03
   Mettre à jour ComfyUI séparément

   Le bouton Update ComfyUI met à jour le cœur. Faites-le quand une extension l'exige, pas par réflexe : chaque mise à jour du cœur peut casser des extensions non maintenues, le README de ComfyUI prévient lui-même que les derniers commits peuvent en casser beaucoup.

Sur ComfyUI Desktop, le cœur se met à jour par l'application et suit la version stable ; le Manager n'y sert qu'aux extensions. Sur la portable et l'installation manuelle, qui suivent les derniers commits, l'instantané est votre seul filet. Un workflow qui marche vaut plus qu'une version plus récente.

#Pour aller plus loin

Le Manager résout les problèmes d'extensions ; il ne remplace pas la compréhension du graphe. Les guides suivants couvrent le reste de la chaîne, de l'installation de ComfyUI aux usages qui exigent des custom nodes.

• ComfyUI : installation et premiers pas en local
• ControlNet : composer ses images, l'usage typique des custom nodes
• Générer des images en local : panorama des outils
• Fooocus : l'alternative sans nœuds ni extensions

Sources officielles consultées pour ce guide : la page du Manager et celle de l'installation des custom nodes dans la documentation de ComfyUI, la page de dépannage des custom nodes, ainsi que le README du dépôt ComfyUI-Manager pour les niveaux de sécurité. Les libellés de menus cités correspondent à l'interface du Manager telle que décrite dans ces pages ; ils peuvent varier d'une version à l'autre.

• Documentation ComfyUI : l'interface du Manager
• Documentation ComfyUI : installer un custom node
• Documentation ComfyUI : dépanner les custom nodes
• Dépôt ComfyUI-Manager (README, niveaux de sécurité)