ComfyUI Desktop : Le Guide d’Installation pas à pas.

Installer ComfyUI Desktop

⚠️

Comme ComfyUI Desktop est toujours en version bêta, le processus d'installation réel peut encore légèrement changer par rapport à ce qui est décris ci-dessous.

Prérequis système

Pour profiter de l’installation facile de ComfyUI Desktop, il faut avant tout se poser la questio de la compatibilité matérielle.

ComfyUI Desktop nécessite une carte graphique ou une puce compatible (NVIDIA sous windows, Apple Silicon sur Mac). Si vous possédez une carte AMD ou Intel, cette version ne fonctionnera malheureusement pas et vous devrez tenter une installation manuelle. Il n’y a pas non plus de version Linux disponible à ce jour.

L'espace disque constitue l'autre prérequis important. Prévoyez au minimum 15 Go d'espace libre pour l'installation initiale, sans compter la place nécessaire pour les modèles que vous téléchargerez par la suite. Attention que ces derniers peuvent rapidement occuper plusieurs dizaines de giga selon vos besoins. Prévoir 50 à 100 Go n'a rien d'excessif si vous comptez explorer différents modèles comme SDXL, Flux, Qwen ou HiDream.

Notez aussi qu’un SSD est fortement recommandé plutôt qu'un disque dur classique : la différence de performances lors du chargement des modèles sera nettement perceptible.

Composant	Windows	Mac
Système d’exploitation	Windows 10 ou 11 (64 bits)	macOS 12.3 (Monterey) ou plus récent
Processeur (CPU)	x64 avec support AVX2	Apple Silicon M2+
Carte graphique (GPU)	NVIDIA obligatoire	GPU Apple intégré (Metal)
Mémoire (RAM)	Minimum 8 Go	Minimum 8 Go
Espace disque	15 Go minimum + pour les modèles	15 Go minimum + pour les modèles
Type de stockage	SSD fortement recommandé	SSD fortement recommandé

Téléchargement

L’installation commence évidemment par le téléchargement depuis le site officiel comfy.org ou directement via le dépôt GitHub du projet.

↓ Version Windows

↓ Version macOS

Alternativement, vous pouvez installer ComfyUI Desktop via homebrew : brew install comfyui

Installation du logiciel

L'installation elle-même ne diffère pas d'un logiciel traditionnel : il suffit d’executer l’installateur que vous venez de télécharger pour lancer l’installation qui se fait en quelques étapes standards.

Marche à suivre sur Windows

Double-cliquez sur le fichier du package d'installation téléchargé, qui effectuera d'abord une installation automatique et créera un raccourci ComfyUI Desktop sur le bureau.

Double-cliquez sur ce raccourci pour accéder à l'initialisation de ComfyUI Desktop.

Marche à suivre sur Mac

Double-cliquez sur le fichier d'installation téléchargé.Faites ensuite glisser l'application ComfyUI dans le dossier Applications en suivant la flèche.

Si l’icone s'affiche avec un signe d'interdictio après l'ouverture du package d'installation, c’est que malheureusement votre version macOS actuelle n'est pas compatible avec ComfyUI Desktop

Recherchez ensuite l'icône ComfyUI dans Launchpad et cliquez dessus pour accéder à l'initialisation de ComfyUI

Initialisation de ComfyUI Desktop

Au premier lancement, ComfyUI Desktop vous guide à travers une série de choix importants pour configurer votre environnement de travail. Cette séquence d'initialisation mérite qu'on s'y attarde étape par étape car elle détermine le comportement futur de l'application.

Une fois sur l’écran de départ cliquer sur Get Started / Démarrer pour débuter l’Initialisation. — Une fois sur l’écran de départ cliquer sur *Get Started* / *Démarrer* pour débuter l’Initialisation.

0. Sélection du mode GPU

L'écran de sélection du GPU propose différentes options dont une seule s'impose vraiment pour la plupart des utilisateurs.

Sur Windows, l’option principale est en effet le choix de la carte NVIDIA qui active le support. PyTorch et CUDA, les technologies qui permettent d'exploiter pleinement la puissance de calcul de votre carte graphique. C'est le choix recommandé qui offre les meilleures performances.

Sur macOS, l’équivalent est le mode MPS : Metal Performance Shaders est le framework qui utilise les GPU internes pour accélérer les tâches de calcul et d'apprentissage automatique sur les appareils Apple.

Les deux autres options qui s’offrent à vous sont les même sur les deux plateformes.

La Configuration Manuelle s'adresse aux utilisateurs avancés qui souhaitent gérer eux-mêmes l'environnement Python. À moins de savoir précisément ce que vous faites et d'avoir une bonne raison de vouloir cette flexibilité supplémentaire, passez votre chemin.

Le mode CPU existe principalement pour des cas d'usage très spécifiques en développement. Les performances seront considérablement réduites comparé à l'utilisation du GPU, rendant la génération d'images particulièrement lente. Cette option ne devrait être envisagée que si vous n'avez vraiment pas le choix.

1. Choix de l’emplacement

Vous allez maintenant choisir le dossier d'installation. ComfyUI y installera trois éléments distincts : l'environnement virtuel Python (qui sera caché dans un dossier .venv), les fichiers de modèles et les nodes personnalisés qui étendent les fonctionnalités de base.

Créez de préférence un nouveau dossier vide dédié à ComfyUI plutôt que de le mélanger avec d'autres applications. Cette séparation facilitera grandement la gestion ultérieure et les éventuelles migrations. Privilégiez également un emplacement sur votre SSD principal si vous en possédez un, car ComfyUI accède régulièrement aux modèles pendant la génération d'images.

2. Migration depuis une installation existante

Cette étape optionnelle intéressera ceux qui utilisaient déjà ComfyUI via la version portable ou une installation manuelle. Le système de migration permet en effet de récupérer vos configurations existantes sans tout recommencer de zéro.

Les fichiers utilisateurs (workflows sauvegardés, paramètres personnalisés) seront copiés directement.

Par contre, pour les checkpoints et fichier de modèles, la logique est différente : plutôt que de les dupliquer et de gaspiller de l'espace disque précieux, ComfyUI Desktop établit simplement des liens vers leur emplacement actuel. Vos fichiers restent là où ils sont, mais l'application sait où les trouver.

Enfin, les custom nodes seront automatiquement réinstallés. Le système les détecte dans votre ancienne installation et les réinstalle dans le nouvel environnement. Cette approche garantit la compatibilité avec l'environnement Python de Desktop et évite tous conflits de dépendances.

3. Configuration des paramètres

L'écran final propose plusieurs paramètres qui méritent réflexion.

Les mises à jour automatiques (Automatic Updates) sont généralement le bon choix : ComfyUI Desktop étant encore jeune, les corrections de bugs et améliorations arrivent régulièrement. Laisser le système se mettre à jour tout seul vous évite de rater des corrections importantes.

La collecte de données d'utilisation anonymes (Usage Metrics) aide les développeurs à identifier les problèmes et prioriser les fonctionnalités. Ces statistiques ne contiennent aucune information personnelle ni vos images générées. C'est une façon simple de contribuer au projet si vous le souhaitez, mais elle reste entièrement optionnelle.

Enfin, les paramètres de miroirs sont utiles si vous rencontrez des difficultés de connexion. L'installation nécessite en effet de télécharger Python et diverses bibliothèques depuis Internet (voir ci-dessous).

⚙

Configuration des miroirs

Étant donné que le programme nécessite un accès Internet pour télécharger Python et terminer l'installation de l'environnement, si vous voyez un ❌ rouge pendant l'installation indiquant que cela peut entraîner un échec de l'installation, suivez ces étapes :

Ouvrez les paramètres (+) pour trouver le(s) miroir(s) défaillant(s). Par exemple, dans la capture d'écran ci-dessus, l'erreur est sur le miroir d’installation Python.

Selon la ou les erreurs, consultez la liste ci-dessous pour changer ceux à utiliser :

Liste des Miroirs

Python Installation Mirror

https://python-standalone.org/mirror/astral-sh/python-build-standalone

PyPI Mirror

https://mirrors.aliyun.com/pypi/simple/ (Alibaba Cloud)

https://mirrors.cloud.tencent.com/pypi/simple/ (Tencent Cloud)

https://pypi.mirrors.ustc.edu.cn/simple/ (UST China)

https://pypi.sjtu.edu.cn/simple/ (Jiao Tong University)

Torch Mirror

https://mirrors.aliyun.com/pytorch-wheels/cu121/ (Aliyun)

4. Terminer l’installation

Si l’initialisation fonctionne comme prévu, le programme d'installation se terminera et entrera automatiquement dans l'interface ComfyUI Desktop et l'installation sera réussie

🪲

Bugs et Erreurs

Plusieurs raisons peuvent causer des problèmes à l’installation de ComfyUI Desktop. Il peut s'agir d'une connexion réseau défaillante lors de l'installation de Pytorch (15 Go). Ou encore, Git n'est pas installé. Pendant l’initialisation, la page de maintenance s'ouvre automatiquement lorsqu'un problème est détecté et propose une solution.

Vous pouvez l'utiliser pour résoudre la plupart des problèmes :

Créer un environnement virtuel Python

Réinstaller toutes les dépendances principales manquantes dans votre environnement virtuel Python géré par Desktop

Installer Git, VC, Redis,…

Choisir un nouvel emplacement d'installation

Par défaut, la page de maintenance affiche le détail de l'erreur en cour :

Cliquer sur All vous permet d'afficher tout le messages pour les différentes étapes, avec ou sans erreur :

La gestion de ComfyUI Desktop

Gestion des modèles

ComfyUI Desktop intègre un système pratique pour réutiliser des modèles stockés ailleurs sur votre ordinateur. Cette fonctionnalité évite la duplication de fichiers volumineux si vous utilisez plusieurs installations de ComfyUI ou d'autres interfaces comme Forge WebUI.

Par défaut, les modèles sont stockés dans le dossier ComfyUI/models. Mais vous pouvez utiliser un fichier de nommé extra_model_paths.yaml pour changer cette configurion Le menu de ComfyUI propose d'ailleurs un accès direct pour ouvrir ce fichier :

La syntaxe du fichier peut sembler intimidante au premier abord mais suit une logique simple. Vous indiquez le chemin vers un dossier qui contient des modèles, et ComfyUI les détecte automatiquement au démarrage.

Le dépôt GitHub propose un fichier d'exemple commenté qui explique les différentes options possibles. Une fois vos modifications sauvegardées, un redémarrage de ComfyUI suffit pour que les nouveaux chemins soient pris en compte.

🗒️

Exemple de configuration des chemins

Disons que vous souhaitez ajouter les chemins de modèle suivants à ComfyUI :

📁 MON_DOSSIER/
  ├── 📁models/
  |   ├── 📁 lora/
  |   │   └── xxxxx.safetensors
  |   ├── 📁 checkpoints/
  |   │   └── xxxxx.safetensors
  |   ├── 📁 vae/
  |   │   └── xxxxx.safetensors
  |   └── 📁 controlnet/
  |       └── xxxxx.safetensors

Vous devrez configurer le fichier extra_model_paths.yaml comme ceci pour permettre à ComfyUI de reconnaître les chemins de modèle sur votre appareil :

ma_config_perso:
    base_path: MON_DOSSIER/models/
    loras: loras
    checkpoints: checkpoints
    vae: vae
    controlnet: controlnet

Enregistrez ensuite le fichier avant de relancer ComfyUI pour qu’il prenne en compte la modification.

Maintenir ComfyUI à jour

Le système de mise à jour de ComfyUI Desktop privilégie la simplicité. Si vous avez activé les mises à jour automatiques lors de l'installation, l'application vérifie régulièrement la disponibilité de nouvelles versions et vous propose de les installer. Le processus s'effectue en arrière-plan sans nécessiter d'intervention particulière de votre part.

Pour les utilisateurs préférant garder le contrôle, le menu "Aide" contient une option "Rechercher les mises à jour" permettant d’effectuer manuellement la mise à jour. Cette approche vous laisse choisir le moment opportun, ce qui peut être appréciable si vous êtes au milieu d'un projet et ne voulez pas risquer de perturbations.

Accéder à l'environnement Python

Même si ComfyUI Desktop automatise la gestion de Python, certaines situations nécessitent d'interagir directement avec l'environnement virtuel. La principale raison étant l'installation de dépendances pour des custom nodes spécifiques.

L'interface intègre un terminal accessible via une icône dans la barre de menu. Ce terminal s'ouvre déjà positionné dans l'environnement virtuel de ComfyUI, évitant les erreurs classiques où les packages s'installent dans le Python système au lieu de l'environnement dédié. Vous pouvez vérifier l'emplacement exact de Python avec des commandes simples si besoin.

Cliquez sur l'icône dans la barre de menu pour ouvrir le panneau inférieur.

Cliquez sur Terminal pour ouvrir le terminal.

Pour vérifier l'emplacement d'installation de Python pour l'environnement correspondant, utilisez la commande “python -c "import sys; print(sys.executable)” sur windows ou “which python” sur macOS.

Cette approche protège votre installation système Python tout en vous donnant la flexibilité nécessaire pour personnaliser votre environnement ComfyUI. Les commandes pip install fonctionnent normalement et installent les packages au bon endroit.

Désinstallation propre

La désinstallation de ComfyUI Desktop est disponible en deux niveaux selon vos besoins.

Une désinstallation simple via les paramètres Windows supprimera l'application elle-même mais préserve tous vos fichiers personnels : modèles, nœuds personnalisés, images générées, workflows sauvegardés.

Cette approche sélective permet de réinstaller ComfyUI ultérieurement en récupérant automatiquement tous vos éléments. Elle convient parfaitement si vous rencontrez des problèmes techniques et souhaitez repartir d'une installation fraîche sans perdre votre travail.

La désinstallation complète nécessite quelques étapes manuelles supplémentaires :

Après avoir désinstallé le programme via Windows, supprimez manuellement les dossiers situés dans AppData. Trois emplacements principaux existent : le dossier d'updater dans Local, le dossier du programme dans Programs, et le dossier de configuration dans Roaming.

N'oubliez pas non plus le dossier d'installation que vous aviez choisi lors de la configuration initiale, qui contient vos modèles et nœuds personnalisés.

Dépannage ComfyUI Desktop

Configuration incompatible

Étant donné que ComfyUI Desktop sur Windows ne prend en charge que les GPU NVIDIA avec CUDA, cet écran peut s'afficher si votre appareil n'est pas compatible.

Dans ce cas, vous devrez opter pour un autre GPU compatible ou vous tourner vers une installation manuelle pour utiliser ComfyUI.

Identification des erreurs

Si l'installation échoue, vous devriez voir l'écran suivant :

Le bouton Show Terminal affiche les messages d'erreur techniques qui peuvent vous donner des indices sur la nature du problème.

Open Logs donne accès aux fichiers journaux complets, particulièrement utiles si vous devez demander de l'aide sur le forum officiel. Le fichier main.log contient les événements liés au démarrage de l'application Electron et du serveur, tandis que comfyui.log enregistre le fonctionnement normal de ComfyUI une fois lancé.

Report Issue vous permet de visiter le forum officiel sur Github pour signaler l’erreur ou demander de l’aide.

Vous pouvez également retenter l’installation avec le bouton Reinstall.

🤖

ChatGPT à la rescousse

Avant de signaler un bug et d’appeller à l’aide sur Github, vous pouvez aussi tenter de résoudre le problème à l’aide de ChatGPT, Claude ou Gemini.

Pour cela, il est conseillé de lui fournir les logs d’erreurs (voir ci-dessus) et de lui demander d’expliquer l’erreur.

Pour ou contre ComfyUI Desktop ?

La version Desktop apporte un avantage majeur qui justifie à lui seul son existence : la simplicité d'installation. Fini le casse-tête de la bonne version de Python à installer, l'apprentissage de Git, ou la configuration manuelle de CUDA pour exploiter votre carte graphique. L'installeur gère tout automatiquement et vous épargne les erreurs classiques qui peuvent bloquer pendant des heures. Pour quelqu'un qui veut simplement utiliser ComfyUI sans devenir expert en ligne de commande, c'est la solution idéale.

Cette facilité a néanmoins son prix, et il vaut mieux le connaître avant de choisir : Les mises à jour arrivent un peu moins vite que sur les autres versions. Quand une nouvelle fonctionnalité sort dans le code source de ComfyUI, les utilisateurs de la version manuelle peuvent l'obtenir immédiatement avec un simple git pull. Avec la version Desktop, vous devrez attendre qu'une nouvelle version officielle soit publiée, ce qui peut prendre plusieurs semaines. Si vous aimez expérimenter avec les toutes dernières innovations dès leur sortie, cette latence peut frustrer.

L'environnement Desktop présente également moins de flexibilité pour les nœuds personnalisés (custom nodes). Certaines extensions développées par la communauté nécessitent en effet des versions spécifiques de bibliothèques ou des procédures d'installation particulières. L'environnement figé de Desktop peut parfois entrer en conflit avec ces exigences, rendant certains nodes avancés inutilisables. Mais, rassurez-vous, la majorité des nœuds populaires fonctionnent sans problème.

Les développeurs et bidouilleurs trouveront Desktop trop contraignant. Si vous voulez modifier le code source de ComfyUI, utiliser des outils de débogage comme VSCode, ou comprendre le fonctionnement interne du système, l'installation depuis GitHub offre un terrain de jeu bien plus riche. Desktop encapsule en effet tout dans une application fermée qui ne se prête pas à ce type d'exploration.

L'accès à distance constitue un autre point de friction. Desktop privilégie l'usage local sur votre propre machine. Certes, il reste techniquement possible de le configurer pour un accès depuis un autre ordinateur, mais les options restent limitées comparé à une installation manuelle où vous contrôlez totalement la configuration réseau.

Enfin, l'interface se présente comme une application dédiée plutôt qu'une page web dans votre navigateur. Cette approche améliore l'intégration système mais vous prive des outils de développement du navigateur. Ces outils s'avèrent parfois précieux pour diagnostiquer certains problèmes ou comprendre ce qui se passe en coulisses. L'absence de console JavaScript et d'inspecteur réseau peut compliquer le dépannage avancé.

Ces limitations ne doivent pas vous décourager si votre objectif reste simplement de générer des images avec ComfyUI. Desktop remplit parfaitement ce rôle pour la grande majorité des utilisateurs. Mais si vous vous reconnaissez dans l'un des profils mentionnés ci-dessus, prenez le temps d'évaluer si la facilité d'installation compense réellement les contraintes.

ComfyUI Desktop