ComfyUI : comprendre, installer, dépanner

Dépanner ComfyUI : trouver la couche qui casse avant de toucher à l'installation

Une erreur ComfyUI vient d'une couche précise — le logiciel, une extension, Python, une dépendance, un modèle, le GPU, la mémoire ou le workflow. Comment on la trouve dans la console, et ce qu'on ne fait pas.

Dépanner ComfyUI commence par identifier la couche en cause : ComfyUI lui-même, une extension, Python, une dépendance, un modèle, le GPU, la VRAM ou le workflow. Le message affiché dans l'interface n'est pas toujours la vraie cause ; la console de lancement montre les extensions chargées, les dépendances manquantes, les erreurs Python, les modèles introuvables et les problèmes CUDA. Chez Axiris, on comprend l'erreur avant de modifier l'installation : après une mise à jour, les custom nodes sont les premiers suspects, et une installation saine ne se réinstalle pas.

Comprendre l'erreur avant de modifier l'installation

Une erreur ComfyUI peut venir de plusieurs couches différentes, et le message visible dans l'interface n'est pas toujours la cause réelle.

Chez Axiris, on cherche d'abord la famille de l'erreur :

ComfyUI → extension → Python → dépendance → modèle → GPU → VRAM → workflow

Cette distinction évite de modifier une installation saine pour une panne qui n'y est pas. On ne réinstalle pas une machine parce qu'un modèle est dans le mauvais dossier.

Lire la console

La console de lancement est la source d'information la plus importante — avant l'interface, avant les forums.

Elle montre :

  • les extensions chargées, et celles qui ont échoué ;
  • les dépendances manquantes ;
  • les erreurs Python, avec la ligne où elles se produisent ;
  • les modèles introuvables ;
  • les problèmes CUDA et l'état du GPU ;
  • l'utilisation mémoire ;
  • l'origine d'un arrêt brutal.

Lire la console en entier, depuis le démarrage, est le geste qui résout le plus de pannes. L'erreur affichée à l'écran est souvent la dernière d'une série ; la première est celle qui compte.

Les extensions d'abord

Quand un problème apparaît après une installation ou une mise à jour, les custom nodes sont les premiers éléments à vérifier.

ComfyUI permet de les désactiver pour savoir si la panne vient du cœur du logiciel ou d'une extension ; on les réactive ensuite une par une jusqu'à trouver la coupable. Le Manager aide à cette manipulation, mais c'est la console qui dit ce qui s'est passé.

La question qui fait gagner du temps

Quand une chaîne qui marchait se met à casser, la question utile n'est pas « qu'est-ce qui a changé ? » — c'est souvent introuvable — mais « qu'est-ce que je fais aujourd'hui que je n'avais pas fait depuis longtemps ? » : un autre format d'image, un modèle qu'on n'avait pas rechargé, une extension dont on n'avait pas ouvert le node depuis des semaines. Une panne qui dort attend un geste rare.

Ce qu'on ne fait pas

On ne met pas tout à jour pour voir. On ne remplace pas une extension par une autre pour faire taire l'erreur. On ne réinstalle pas ComfyUI avant d'avoir lu la console. Chacun de ces gestes peut faire disparaître le symptôme en cachant la cause — et elle revient.

Références officielles : Guide de dépannage · Dépannage des custom nodes.

Demander à l'IA ComfyUI

Vous pouvez transmettre une erreur, un extrait de console ou décrire votre installation à l'IA ComfyUI de Synnexia. Son rôle est d'aider à chercher la cause, pas de proposer une suite de commandes au hasard.

Quand l'installation n'est plus tenable

Il arrive qu'une installation ait trop vécu : des extensions empilées, des versions qu'on ne sait plus retracer, une panne par semaine. Axiris la reconstruit avec vous, en gardant vos modèles et vos workflows, ou vous la fournit prête : une machine en Suisse, louée à l'heure, ComfyUI et Nova installés, maintenue dans la durée si vous le souhaitez (mise en place et accompagnement).

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.