Pour résoudre les erreurs de ComfyUI sur http://127.0.0.1:8188, vérifions d’abord que le serveur Python fonctionne, puis consultons ses journaux d’erreurs avant de modifier le navigateur, les extensions ou les nœuds personnalisés. Cette méthode de dépannage permet de distinguer une panne du serveur d’un problème de mémoire GPU, de port réseau ou d’installation.
Lorsque l’interface affiche « Reconnecting… », elle a perdu sa connexion au serveur local. Le navigateur n’indique pas toujours la cause : un processus arrêté, une mémoire vidéo saturée ou une dépendance Python manquante peuvent produire le même symptôme. Pour avancer sans dérégler une installation fonctionnelle, procédons du diagnostic le plus simple aux vérifications plus spécialisées.
- Commencez par le terminal : cherchez une erreur apparue au moment du blocage.
- Testez l’adresse locale : ouvrez 127.0.0.1:8188 après avoir vérifié que ComfyUI est lancé.
- Réduisez les variables : essayez un workflow minimal et désactivez temporairement les nœuds personnalisés.
Chaque étape ci-dessous vise une cause différente, avec des exemples pour Windows, macOS et Linux. Nous suivrons le cas de Léa, qui lance une génération en 1024 × 1024 et voit l’interface se reconnecter en boucle : son parcours montre pourquoi il vaut mieux lire les indices avant de réinstaller toute l’application.
Comprendre l’erreur localhost 8188
L’adresse 127.0.0.1 désigne la machine que vous utilisez : c’est l’adresse de boucle locale, souvent appelée localhost. Le nombre 8188 correspond au port réseau utilisé par défaut par de nombreuses installations manuelles et versions portables de ComfyUI. Lorsque le navigateur ouvre cette adresse, il communique avec un serveur Python qui tourne sur votre ordinateur.
Cette communication ne se limite pas au chargement initial d’une page. L’interface conserve également une connexion WebSocket, un canal persistant qui transmet l’état des tâches et les images produites. Si le serveur s’arrête pendant le chargement d’un modèle ou l’exécution d’un nœud, le navigateur perd ce canal et peut afficher « Reconnecting… » sans expliquer ce qui a interrompu le processus.
Identifier le symptôme exact
Commençons par distinguer une interruption brève d’une panne durable. Si le bandeau disparaît après quelques secondes et que la génération reprend, le serveur a pu être temporairement occupé. Si le message reste affiché plus d’une minute, que la file d’attente revient à zéro ou que le terminal présente une trace Python, le processus s’est probablement arrêté ou ne répond plus.
Dans le cas de Léa, l’interface affiche le bandeau rouge juste après « Queue Prompt ». Elle ouvre le terminal de lancement et repère une erreur de mémoire CUDA. L’adresse locale n’est donc pas la cause : le serveur s’est interrompu pendant le calcul, laissant le navigateur sans interlocuteur. Cette distinction évite de perdre du temps à modifier les paramètres du routeur pour une panne qui se produit entièrement sur la machine.
Vérifier l’adresse et le port
La version utilisée compte aussi. Certaines installations Desktop peuvent employer un port différent, souvent 8000 selon leur configuration, tandis que les versions portables ou installées manuellement utilisent généralement 8188. Fiez-vous à l’adresse affichée dans le terminal au démarrage, plutôt qu’à un favori enregistré il y a plusieurs mois.
Fermez les anciens onglets, puis saisissez l’adresse indiquée, par exemple http://127.0.0.1:8188. Si la page ne répond pas, vérifiez d’abord que le terminal est toujours ouvert et que ComfyUI a terminé son lancement. Une adresse locale n’est accessible que si le serveur correspondant tourne effectivement.
Un message « connexion refusée » indique souvent que rien n’écoute sur le port demandé. Un écran qui charge sans fin peut plutôt signaler un serveur occupé, une incompatibilité d’interface ou un blocage du canal WebSocket. Repérer le type d’échec constitue déjà une première étape de résolution des erreurs.
Lire les journaux d’erreurs
Avant de réinstaller ComfyUI, consultez le terminal ou la fenêtre de commande utilisée au démarrage. Les journaux d’erreurs permettent souvent de remonter directement à la cause : ils indiquent si le serveur a rencontré une erreur Python, un problème de mémoire, un port déjà occupé ou un module introuvable. Le navigateur montre le symptôme ; le terminal révèle généralement l’événement qui l’a provoqué.
Repérez les dernières lignes produites au moment précis où l’interface décroche. Une erreur ancienne, apparue pendant le démarrage et suivie d’un lancement normal, n’a pas forcément de lien avec le problème actuel. Pour Léa, la mention « CUDA out of memory » survient dès que son workflow complexe démarre : elle dispose ainsi d’un indice concret, plutôt que d’une simple impression que « ComfyUI ne répond plus ».
Associer les messages aux causes
Quelques termes aident à orienter le diagnostic. « CUDA out of memory » indique une mémoire vidéo insuffisante pour l’opération demandée ; « ModuleNotFoundError » ou « ImportError » renvoie souvent à une dépendance absente ou incompatible ; « Address already in use » signifie qu’un autre processus utilise déjà le port choisi. Une trace Python (traceback) donne la succession des appels qui ont conduit à l’arrêt.
Voici comment exploiter ces indices sans modifier plusieurs réglages à la fois :
- Erreur CUDA ou OOM : réduisez la résolution ou la taille du lot, puis retestez.
- Module introuvable : vérifiez l’environnement Python actif et les dépendances nécessaires.
- Port déjà utilisé : identifiez le processus concerné ou choisissez un autre port.
- Nom d’un nœud dans la trace : désactivez ce nœud pour vérifier s’il déclenche l’erreur.
Les commandes exactes dépendent de votre installation. Dans une version manuelle, activez d’abord le bon environnement virtuel avant de lancer des commandes comme pip check ou de réinstaller les exigences du projet. Si plusieurs versions de Python sont installées, une commande pip exécutée dans le mauvais environnement peut ne rien corriger, même si elle se termine sans erreur.
Tester le serveur séparément
Si le terminal indique que le serveur tourne, essayez de rouvrir l’adresse locale dans un autre onglet. Une vérification HTTP, par exemple sur http://127.0.0.1:8188/system_stats lorsque cet endpoint est disponible dans votre version, peut montrer si le backend répond. Une réponse valide oriente davantage vers le navigateur ou le WebSocket ; une connexion refusée indique plutôt un processus arrêté ou un port incorrect.
Dans les outils de développement du navigateur, accessibles avec F12, l’onglet Réseau peut afficher les connexions WebSocket. Un code de fermeture 1006 correspond à une fermeture anormale et justifie une vérification du terminal, sans constituer à lui seul une preuve de panne GPU. Les journaux et l’observation du processus restent les repères les plus fiables pour décider de la suite.
Avant de demander de l’aide, copiez le message complet, les lignes qui le précèdent et votre configuration matérielle. Ces éléments donnent à la communauté un point de départ vérifiable et évitent les conseils au hasard.
Rétablir la connexion au serveur
Si le serveur semble actif, mais que l’interface ne revient pas, avançons par des tests réversibles. Actualisez d’abord la page avec Ctrl + R. Si l’ancienne interface reste chargée après une mise à jour, essayez un rechargement forcé avec Ctrl + Maj + R : le navigateur récupère alors les ressources plutôt que de réutiliser certaines données en cache.
Quand le terminal ne produit plus de réponse ou affiche une erreur fatale, arrêtez proprement le processus avec Ctrl + C dans sa fenêtre, attendez quelques secondes, puis relancez ComfyUI. Patientez jusqu’à ce que le terminal annonce l’adresse de l’interface avant de rouvrir l’onglet. Fermer seulement l’onglet ne redémarre pas le backend.
Écarter navigateur et extensions
Les bloqueurs de publicité, outils de confidentialité, extensions VPN et filtres de scripts peuvent perturber une connexion locale persistante. Testez ComfyUI dans une fenêtre privée, où la plupart des extensions sont désactivées, ou dans un autre navigateur. Si la page fonctionne ainsi, réactivez vos extensions une par une afin d’identifier celle qui bloque localhost, puis ajoutez une exception pour l’adresse locale quand le logiciel le permet.
Un cache obsolète peut aussi gêner l’interface après une mise à jour du frontend. Le rechargement forcé est un bon premier essai ; effacer les fichiers en cache ne vient qu’ensuite. Les réglages réseau du navigateur, un proxy système ou un VPN peuvent également intervenir. Désactivez-les temporairement pour tester, puis créez une exception adaptée plutôt que de laisser la protection désactivée.
Résoudre un conflit de port
Deux instances de ComfyUI ouvertes en même temps peuvent se disputer le port 8188. Sur Windows, la commande netstat -ano | findstr :8188 aide à repérer un processus qui l’occupe ; le numéro PID affiché peut ensuite être recherché dans le Gestionnaire des tâches. Sur macOS ou Linux, la commande lsof -i :8188 peut identifier le processus correspondant.
Ne terminez pas un processus inconnu sans vérifier ce qu’il fait. Vous pouvez aussi démarrer ComfyUI sur un autre port, par exemple avec python main.py –port 8189, puis ouvrir l’adresse correspondante. Si le port alternatif fonctionne, le conflit est confirmé ; il reste à identifier le logiciel qui occupait 8188 ou à conserver le nouveau port de façon cohérente.
Pour un accès depuis un autre appareil du réseau local, l’adresse 127.0.0.1 ne suffit pas : elle renvoie à l’appareil qui consulte la page. Il faut configurer l’écoute réseau, connaître l’adresse IP locale de l’ordinateur serveur et appliquer des règles de pare-feu prudentes. N’exposez pas le service directement à Internet sans comprendre les implications de sécurité et sans mettre en place une protection adaptée.
Une reconnexion réussie après changement de navigateur, rechargement ou port alternatif isole une partie du problème. Notez le test concluant : il vous évitera de répéter les mêmes manipulations lors d’un prochain incident.
Corriger mémoire et nœuds
Si l’erreur survient uniquement au lancement d’un workflow, la machine peut manquer de mémoire vidéo, ou un nœud personnalisé peut échouer pendant le calcul. Une résolution plus élevée, un lot d’images plus important ou un modèle plus exigeant augmentent les ressources nécessaires. Le serveur peut alors s’arrêter, ce qui transforme un problème de génération en erreur de connexion apparente.
Pour tester l’hypothèse mémoire, observez l’utilisation du GPU au moment de la génération et fermez les applications qui consomment aussi sa mémoire. Réduisez la taille des images ou le nombre d’images traitées simultanément, puis lancez à nouveau le workflow. Pour Léa, passer de quatre images à une seule et tester à 512 × 512 permet de vérifier si la charge est responsable, sans toucher à ses fichiers d’installation.
Réduire la charge de calcul
Les options de lancement comme –lowvram ou –medvram peuvent aider selon la mémoire disponible et la version de ComfyUI. Elles ne garantissent pas une accélération : leur effet dépend du modèle, du workflow et du matériel. Le mode CPU peut servir à vérifier si le problème vient du chemin GPU, mais la génération sera généralement beaucoup plus lente.
Ne changez qu’un paramètre à la fois. Si vous réduisez simultanément la résolution, changez de modèle et désactivez des nœuds, vous ne saurez pas quel ajustement a rétabli la stabilité. Notez les paramètres qui fonctionnent : cette petite fiche est utile lorsque vous alternez entre des workflows légers et des modèles plus gourmands.
Isoler un nœud personnalisé
Les extensions de la communauté ajoutent des fonctions précieuses, mais certaines peuvent devenir incompatibles après une mise à jour ou dépendre de modules particuliers. Pour tester cette piste, désactivez temporairement les nœuds personnalisés depuis leur gestionnaire, ou renommez leur dossier après avoir arrêté ComfyUI. Si le workflow minimal fonctionne ensuite, le problème se situe probablement dans un nœud, ses dépendances ou son interaction avec le workflow.
Réactivez alors les extensions progressivement, en redémarrant et en testant après chaque petit groupe, voire une par une si vous en avez peu. Consultez la page du projet concerné pour vérifier les versions prises en charge et les incidents déjà signalés. Une trace Python qui nomme un module ou un fichier précis constitue un indice plus fort qu’une simple corrélation avec la dernière extension installée.
Pour obtenir un test de référence, chargez un workflow simple : modèle connu, enchaînement de base, résolution modeste, une image et un nombre limité d’étapes. Si ce test réussit, réintroduisez progressivement les composants du workflow original. Vous saurez ainsi si le blocage vient d’un modèle, d’un nœud précis ou d’une charge trop élevée, au lieu de réinstaller toute l’application par réflexe.
| Symptôme observé | Piste à vérifier | Premier test utile |
|---|---|---|
| La génération interrompt la page | Mémoire GPU ou système | Réduire résolution et lot |
| Erreur après ajout d’une extension | Nœud ou dépendance | Désactiver les nœuds personnalisés |
| « Address already in use » | Conflit de port réseau | Identifier le processus ou tester 8189 |
| ModuleNotFoundError au démarrage | Environnement Python | Vérifier l’environnement et les exigences |
Lorsque le workflow minimal passe et que l’original échoue, conservez les deux versions pour comparer leurs composants. Ce test différentiel transforme une panne confuse en recherche ciblée.
Stabiliser installation et dépendances
Quand ComfyUI ne démarre pas ou s’interrompt dès le lancement, examinez l’installation avant de supprimer des fichiers. Une mise à jour du cœur peut coïncider avec des dépendances Python manquantes, une version de PyTorch inadaptée ou un nœud personnalisé qui attend un autre environnement. Le fait que le problème apparaisse après une mise à jour est un indice utile, mais il faut le confirmer à partir des journaux.
Dans une installation manuelle, vérifiez que vous exécutez les commandes depuis le bon dossier et que l’environnement virtuel associé est activé. La commande pip check peut signaler des incompatibilités entre paquets. Pour réinstaller les dépendances déclarées par le projet, utilisez le fichier requirements correspondant à votre version, sans mélanger les paquets de plusieurs installations de ComfyUI.
Mettre à jour avec méthode
Avant une mise à jour importante, sauvegardez les workflows, les modèles et la liste des versions installées. Dans un environnement Python, pip freeze > versions.txt enregistre l’état des paquets et peut faciliter un retour en arrière. Cette précaution ne remplace pas une sauvegarde des fichiers de modèles : ceux-ci peuvent être volumineux et ne sont pas toujours copiés lors d’une migration.
Après une mise à jour, suivez les instructions officielles correspondant à votre type d’installation. Une version portable, l’application Desktop et une installation manuelle n’utilisent pas nécessairement le même Python ni le même emplacement de paquets. Installer un module dans le Python global alors que ComfyUI utilise un environnement isolé ne corrigera pas le problème de cet environnement.
Si une version récente déclenche l’échec, vérifiez les notes du projet et les signalements des extensions avant de revenir à une version antérieure. Évitez de copier aveuglément une commande trouvée pour une autre carte graphique ou une autre version de CUDA : un paquet PyTorch construit pour un matériel différent peut créer une nouvelle panne au lieu de résoudre la précédente.
Choisir la bonne installation
Les versions Desktop peuvent imposer des conditions matérielles ou système spécifiques. Si l’application signale un GPU non pris en charge, consultez sa documentation et choisissez une méthode compatible avec votre matériel plutôt que de forcer l’installation. Sur macOS, les permissions de sécurité peuvent bloquer l’ouverture ; sur Linux, une bibliothèque système ou un pilote manquant peut apparaître dans les journaux. Chaque plateforme mérite un diagnostic adapté.
Pour un appareil NVIDIA, vérifiez le pilote et la compatibilité entre PyTorch et CUDA avant de réinstaller l’ensemble. Les GPU AMD reposent sur des solutions différentes, souvent dépendantes du système et de la prise en charge ROCm. Les puces Apple utilisent leur propre backend matériel, tandis que les cartes Intel s’appuient sur XPU plutôt que sur CUDA. Une erreur mentionnant CUDA sur une carte Intel ne se résout donc pas en installant un paquet CUDA destiné à NVIDIA.
Une réinstallation propre devient raisonnable lorsque l’environnement est manifestement incohérent et que les tests précédents n’ont rien résolu. Préservez au minimum vos modèles, workflows et paramètres, installez ComfyUI dans un dossier distinct, puis validez le lancement avec un workflow simple avant de remettre toutes les extensions. Cette approche garde un point de comparaison fonctionnel et réduit le risque de reproduire la panne dans le nouvel environnement.
Si le blocage persiste, transmettez un rapport utile sur le dépôt ou le forum correspondant : système d’exploitation, type d’installation, carte graphique, version de Python, étapes exactes et extrait complet des journaux autour de l’erreur. Pour un problème propre à une extension, contactez plutôt son développeur. Un signalement précis accélère le dépannage collectif et permet de retrouver plus vite une connexion stable à localhost.