ComfyUI : comprendre, installer, dépanner

Custom nodes : les extensions de ComfyUI

Ce qu'une extension de la communauté ajoute, ce qu'elle coûte en dépendances et en compatibilité, comment on la choisit, comment on l'installe proprement et comment on trouve celle qui casse.

Les custom nodes sont les extensions de ComfyUI écrites par la communauté : chacune ajoute une opération que le cœur du logiciel ne fait pas, au prix d'une dépendance de plus et d'une compatibilité à vérifier à chaque mise à jour. On choisit une extension comme un dépôt vivant — maintenu, suivi, installé en clonant ce dépôt et non en copiant un dossier figé — pour savoir d'où vient chaque brique et pouvoir la mettre à jour. Chez Axiris, quand une fonction manque, on écrit son propre node plutôt que d'empiler des extensions.

Ce qu'une extension ajoute

ComfyUI est livré avec un ensemble de nodes intégrés, maintenus avec le logiciel. Un custom node est une extension écrite par quelqu'un d'autre : elle ajoute au graphe une ou plusieurs opérations que le cœur ne fait pas — un nouveau type de modèle, une méthode de correction, un traitement vidéo, un outil de confort.

C'est ce qui fait la richesse de l'écosystème. La plupart des usages avancés passent par au moins une extension, et la plupart des workflows partagés en supposent plusieurs.

Ce qu'une extension coûte

Une extension n'est jamais gratuite pour l'installation qui la reçoit.

Une dépendance de plus. Elle apporte souvent ses propres bibliothèques Python, parfois une version précise, parfois en conflit avec celle qu'une autre extension exige. Deux extensions qui demandent chacune une autre version de la même bibliothèque ne peuvent pas cohabiter sans arbitrage.

Une compatibilité à vérifier à chaque mise à jour. Le cœur de ComfyUI évolue vite. Une extension qui fonctionnait hier peut ne plus se charger après une mise à jour du logiciel — ou l'inverse : l'extension change, et le workflow qui l'employait rend autre chose, sans erreur. Un graphe désaligné ne plante pas toujours ; il peut simplement produire un résultat différent.

Du code qui tourne sur votre machine. Une extension s'exécute avec les mêmes droits que ComfyUI. Son origine compte.

Comment on choisit

Avant d'installer, on regarde trois choses.

Le dépôt est-il vivant : maintenu, mis à jour quand ComfyUI change, avec des problèmes signalés et traités ? Un dépôt abandonné devient une panne en attente.

Fait-elle une chose que vous ne savez pas faire autrement ? Une extension qui duplique un node du cœur ajoute une dépendance pour rien.

Que demande-t-elle comme bibliothèques, et sont-elles compatibles avec ce qui est déjà installé ?

Installer proprement : cloner, pas copier

Une extension s'installe en clonant son dépôt — par le Manager ou à la main — et non en copiant un dossier récupéré quelque part. La différence n'est pas un détail : une copie est une version figée qui ne dit pas qu'elle l'est. On ne sait plus d'où elle vient, on ne peut pas la mettre à jour, et le jour où elle casse, on ne sait pas ce qu'on compare.

Un clone sait d'où il vient. Il se met à jour, il se compare à son origine, et quand deux versions se comportent différemment, on peut dire laquelle a changé. Chez Axiris, c'est une règle d'atelier : on sait d'où vient chaque brique.

Quand une extension casse

La console de lancement dit quelles extensions se sont chargées et lesquelles ont échoué, et pourquoi : une bibliothèque manquante, une version incompatible, une erreur dans le code. C'est là qu'on lit, avant de toucher à quoi que ce soit.

Quand le problème apparaît après une installation ou une mise à jour, on désactive les extensions pour savoir si la panne vient du cœur ou de l'une d'elles, puis on les réactive une par une. Une mise à jour n'est pas une réparation : on cherche la cause, on ne remplace pas une extension par une autre pour faire taire l'erreur. La méthode complète est dans Dépanner ComfyUI.

Quand la fonction n'existe pas

Il arrive qu'aucune extension ne fasse ce qu'un workflow demande, ou qu'elle le fasse au prix d'une dépendance qu'on ne veut pas. Chez Axiris, on écrit alors son propre node : une brique qu'on comprend, qu'on maintient et qu'on peut livrer avec le workflow.

Références officielles : Documentation : Custom Nodes · Dépannage des custom nodes.

Une extension vous bloque, ou une fonction vous manque ? Demande de contact — un premier échange offert, sans engagement : chaque pratique est différente, c'est en vous écoutant qu'on propose ce qui vous convient.