CommunityImagegithub.com

Configuration de ComfyUI

Installation locale de ComfyUI, gestion des modèles, workflows et dépannage pour la génération d'images/vidéos/3D sous Windows avec RTX 3090.

Qu'est-ce que Configuration de ComfyUI ?

Cette compétence fournit un guide complet pour installer et configurer ComfyUI localement sur une machine Windows équipée d'une RTX 3090 24 Go. Elle couvre la structure de dossiers, la gestion centralisée des modèles via `extra_model_paths.yaml`, l'organisation des workflows (2D/3D/vidéo), et les commandes de lancement spécifiques (normal et vidéo H3). Elle explique les règles critiques pour éviter les erreurs, comme la double mise à jour des champs `widgets_values` et `widgets_values_named`, le redémarrage obligatoire après ajout de modèles, et les ajustements de RAM (`int8/FP8` pour 28 Go, BF16 nécessitant 40 Go). La compétence inclut une procédure détaillée d'installation de nouveaux modèles avec vérification de l'en-tête safetensors, une table de référence des modèles clés (Z-Image Turbo, Nova Anime XL, etc.) et leurs paramètres optimaux, ainsi qu'un tableau de dépannage des problèmes fréquents (échec d'hôte, écran noir, modèles manquants). Elle s'appuie sur une documentation locale structurée (README, SETUP_DOCUMENTATION, HANDOFF, PROJECTS) et liste les modèles non installés disponibles sur demande. Cette compétence est destinée aux utilisateurs de ComfyUI sur Windows avec GPU NVIDIA, cherchant à optimiser leur installation pour la génération d'images, vidéos et 3D tout en évitant les pièges courants.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/konqiDAM/void-skills/tree/main/comfyui-setup

Installed? Explore more Image skills: steipete/songsee, affaan-m/frontend-design, mattpocock/improve-codebase-architecture · View all 6 →

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Configuration de ComfyUI — Génération IA locale

Machine

  • Windows 10 Pro, RTX 3090 24 Go (Ampere), 28 Go RAM (→ 40 Go), Xeon E5-2696 v4
  • Disques : C: (OS, 35 Go libres), D: SSD 207 Go, E: HDD 9,3 To
  • ComfyUI 0.44.0 portable (CUDA 13, Python 3.13) dans D:\AI\ComfyUI
  • Serveur : http://127.0.0.1:8188

Structure des dossiers

  • D:\AI\ComfyUI — application + python_embeded
  • D:\AI\models\ — tous les modèles (via extra_model_paths.yaml)
  • D:\AI\workflows\ — dossiers 2d/, 3d/, video/ contenant les JSON de workflows
  • D:\AI\outputs\staging\<projet>\ — staging par projet
  • D:\AI\cache\ — téléchargements HF/Torch (HF_HOME, TORCH_HOME)
  • D:\AI\README.txt, SETUP_DOCUMENTATION.md, HANDOFF.md, PROJECTS.md

Dossiers de modèles

TypeDossierChargeur
Checkpoint SDXLD:\AI\models\checkpoints\CheckpointLoaderSimple
Modèle de diffusion (UNET)D:\AI\models\diffusion_models\UNETLoader
Encodeur de texteD:\AI\models\text_encoders\CLIPLoader
VAED:\AI\models\vae\VAELoader
ControlNet/patchD:\AI\models\model_patches\ModelPatchLoader
LoRAD:\AI\models\loras\LoraLoader
CLIP visionD:\AI\models\clip_vision\CLIPVisionLoader
UpscaleD:\AI\models\upscale_models\UpscaleModelLoader
Suppression d'arrière-planD:\AI\models\background_removal\LoadBackgroundRemovalModel
3DD:\AI\models\diffusion_models\ + vae\Nœuds 3D natifs

Règles critiques

  1. Les deux champs widgets_values ET widgets_values_named doivent être mis à jour lors du changement de nom de modèle dans un workflow. ComfyUI 0.44.0 utilise widgets_values_named pour les valeurs réelles.
  2. Redémarrez ComfyUI après avoir ajouté des modèles (la liste des modèles est mise en cache au démarrage).
  3. Cache du navigateur : si un message "modèle manquant" apparaît, rechargez la page (F5) et rouvrez le workflow.
  4. Les builds int8/FP8 sont nécessaires pour 28 Go de RAM. BF16 nécessite 40 Go.
  5. H3 nécessite : les drapeaux --disable-pinned-memory --fp16-intermediates.
  6. Ne mélangez pas les types de modèles. Z-Image utilise UNET/CLIP/VAE (séparés). Les checkpoints SDXL utilisent CheckpointLoaderSimple.
  7. extra_model_paths.yaml utilise des slashes : D:/AI/models/.
  8. Le cache HF/Torch doit être sur D: (défini dans le bat de lancement).
  9. Les nœuds MarkdownNote peuvent référencer des noms de modèles dans le texte ; nettoyez-les pour éviter de faux avertissements de "modèle manquant".

Installer un nouveau modèle

  1. Téléchargez dans D:\AI\downloads\ via curl.
  2. Déplacez dans le bon dossier sous D:\AI\models\.
  3. Vérifiez l'en-tête safetensors :
    D:\AI\ComfyUI\python_embeded\python.exe -c "import struct,json,sys; sys.stdout.reconfigure(encoding='utf-8'); f=open(r'<chemin>','rb'); n=struct.unpack('<Q',f.read(8))[0]; h=json.loads(f.read(n)); print('OK', len(h), 'tensors')"
    
  4. Redémarrez ComfyUI.
  5. Vérifiez que le chargeur le voit via http://127.0.0.1:8188/object_info/<ChargeurNode>.
  6. Créez un workflow à partir d'un modèle existant, mettez à jour widgets_values et widgets_values_named.
  7. Testez via l'API (voir test_zimage.py pour le modèle).
  8. Mettez à jour README et la documentation.

Commandes de lancement

:: Normal (images, 3D, général)
D:\AI\ComfyUI\run_nvidia_gpu.bat
:: --enable-manager

:: Vidéo (MiniMax H3)
D:\AI\ComfyUI\run_nvidia_gpu_video.bat
:: --enable-manager --disable-pinned-memory --fp16-intermediates

Modèles et paramètres clés

ModèleFichiersParamètres
Z-Image TurboUNET int8 + encodeur FP8 + ae.safetensors8-9 steps, CFG 1.0, res_multistep, simple, 1024-1344px
Nova Anime XL v19NovaAnimeILV190.safetensors (SDXL)28 steps, CFG 5, euler_ancestral, normal, CLIP skip 2
Prefect Pony XL v6PrefectPonyXLV6.safetensors (Pony/SDXL)28 steps, CFG 6, euler_ancestral, normal, CLIP skip 2
Pixal3D/TRELLIS.2UNETs int8 + VAEs + DINOv3 + BiRefNet + MoGe1024px, booléen : off=Pixal3D, on=TRELLIS.2
MiniMax H3int8 élagué + encodeur NVFP4 + VAEs vidéo/audio5s 864x480, LoRA turbo 4-step ; 15s 1344x768 ~23 min

Problèmes courants

ProblèmeSolution
hostbuf_file_reader_read failed--disable-dynamic-vram ou utiliser des builds int8/FP8
Fault failed: 2 (H3)--disable-pinned-memory --fp16-intermediates + résolution plus basse
Écran noir (TDR)Réduire la résolution/les steps ; augmenter le délai TDR dans le registre
Boîte de dialogue "Modèle manquant"Corriger les deux champs widgets ; redémarrer ComfyUI ; recharger la page
Modèle absent du menu déroulantRedémarrer ComfyUI (liste mise en cache au démarrage)
Échec I2V H3FL2VA non installé ; utiliser le workflow R2V sûr

Fichiers de documentation

  • D:\AI\README.txt — référence rapide utilisateur
  • D:\AI\SETUP_DOCUMENTATION.md — référence complète en 13 sections
  • D:\AI\HANDOFF.md — référence rapide agent (procédures d'installation)
  • D:\AI\PROJECTS.md — suivi des projets
  • D:\AI\projects<slug>\README.md — documentation par projet

Non installés (disponibles sur demande)

SDXL base, FLUX, LoRAs pixel-art, SDXL ControlNet, H3 FL2VA, modèles d'upscale (ESRGAN/SeedVR2), LoRAs de texture, outils d'entraînement Kohya, Krita AI Diffusion, Aseprite/Pixelorama.

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

Skills associés