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
| Type | Dossier | Chargeur |
|---|
| Checkpoint SDXL | D:\AI\models\checkpoints\ | CheckpointLoaderSimple |
| Modèle de diffusion (UNET) | D:\AI\models\diffusion_models\ | UNETLoader |
| Encodeur de texte | D:\AI\models\text_encoders\ | CLIPLoader |
| VAE | D:\AI\models\vae\ | VAELoader |
| ControlNet/patch | D:\AI\models\model_patches\ | ModelPatchLoader |
| LoRA | D:\AI\models\loras\ | LoraLoader |
| CLIP vision | D:\AI\models\clip_vision\ | CLIPVisionLoader |
| Upscale | D:\AI\models\upscale_models\ | UpscaleModelLoader |
| Suppression d'arrière-plan | D:\AI\models\background_removal\ | LoadBackgroundRemovalModel |
| 3D | D:\AI\models\diffusion_models\ + vae\ | Nœuds 3D natifs |
Règles critiques
- 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.
- Redémarrez ComfyUI après avoir ajouté des modèles (la liste des modèles est mise en cache au démarrage).
- Cache du navigateur : si un message "modèle manquant" apparaît, rechargez la page (F5) et rouvrez le workflow.
- Les builds int8/FP8 sont nécessaires pour 28 Go de RAM. BF16 nécessite 40 Go.
- H3 nécessite : les drapeaux
--disable-pinned-memory --fp16-intermediates.
- Ne mélangez pas les types de modèles. Z-Image utilise UNET/CLIP/VAE (séparés). Les checkpoints SDXL utilisent CheckpointLoaderSimple.
- extra_model_paths.yaml utilise des slashes :
D:/AI/models/.
- Le cache HF/Torch doit être sur D: (défini dans le bat de lancement).
- 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
- Téléchargez dans
D:\AI\downloads\ via curl.
- Déplacez dans le bon dossier sous
D:\AI\models\.
- 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')"
- Redémarrez ComfyUI.
- Vérifiez que le chargeur le voit via
http://127.0.0.1:8188/object_info/<ChargeurNode>.
- Créez un workflow à partir d'un modèle existant, mettez à jour
widgets_values et widgets_values_named.
- Testez via l'API (voir
test_zimage.py pour le modèle).
- 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èle | Fichiers | Paramètres |
|---|
| Z-Image Turbo | UNET int8 + encodeur FP8 + ae.safetensors | 8-9 steps, CFG 1.0, res_multistep, simple, 1024-1344px |
| Nova Anime XL v19 | NovaAnimeILV190.safetensors (SDXL) | 28 steps, CFG 5, euler_ancestral, normal, CLIP skip 2 |
| Prefect Pony XL v6 | PrefectPonyXLV6.safetensors (Pony/SDXL) | 28 steps, CFG 6, euler_ancestral, normal, CLIP skip 2 |
| Pixal3D/TRELLIS.2 | UNETs int8 + VAEs + DINOv3 + BiRefNet + MoGe | 1024px, booléen : off=Pixal3D, on=TRELLIS.2 |
| MiniMax H3 | int8 élagué + encodeur NVFP4 + VAEs vidéo/audio | 5s 864x480, LoRA turbo 4-step ; 15s 1344x768 ~23 min |
Problèmes courants
| Problème | Solution |
|---|
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éroulant | Redémarrer ComfyUI (liste mise en cache au démarrage) |
| Échec I2V H3 | FL2VA 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.