Configuración de ComfyUI — Generación Local de IA
Máquina
- Windows 10 Pro, RTX 3090 24 GB (Ampere), 28 GB RAM (→40 GB), Xeon E5-2696 v4
- Unidades: C: (SO, 35 GB libres), D: SSD 207 GB, E: HDD 9.3 TB
- ComfyUI 0.44.0 portable (CUDA 13, Python 3.13) en
D:\AI\ComfyUI
- Servidor:
http://127.0.0.1:8188
Estructura de carpetas
D:\AI\ComfyUI — app + python_embeded
D:\AI\models\ — todos los modelos (vía extra_model_paths.yaml)
D:\AI\workflows\ — 2d/, 3d/, video/ JSON de flujos de trabajo
D:\AI\outputs\staging\<projecto>\ — staging por proyecto
D:\AI\cache\ — descargas HF/Torch (HF_HOME, TORCH_HOME)
D:\AI\README.txt, SETUP_DOCUMENTATION.md, HANDOFF.md, PROJECTS.md
Carpetas de modelos
| Tipo | Carpeta | Cargador |
|---|
| Punto de control SDXL | D:\AI\models\checkpoints\ | CheckpointLoaderSimple |
| Modelo de difusión (UNET) | D:\AI\models\diffusion_models\ | UNETLoader |
| Codificador de texto | D:\AI\models\text_encoders\ | CLIPLoader |
| VAE | D:\AI\models\vae\ | VAELoader |
| ControlNet/parche | D:\AI\models\model_patches\ | ModelPatchLoader |
| LoRA | D:\AI\models\loras\ | LoraLoader |
| CLIP vision | D:\AI\models\clip_vision\ | CLIPVisionLoader |
| Sobreescalado | D:\AI\models\upscale_models\ | UpscaleModelLoader |
| Eliminación de fondo | D:\AI\models\background_removal\ | LoadBackgroundRemovalModel |
| 3D | D:\AI\models\diffusion_models\ + vae\ | Nodos 3D nativos |
Reglas críticas
- Tanto
widgets_values COMO widgets_values_named deben actualizarse al cambiar nombres de modelos en un flujo de trabajo. ComfyUI 0.44.0 usa widgets_values_named para los valores reales.
- Reiniciar ComfyUI después de añadir modelos (la lista de modelos se almacena en caché al inicio).
- Caché del navegador: Si aparece "modelo faltante", recargar la página (F5) y reabrir el flujo de trabajo.
- Builds int8/FP8 requeridos para 28 GB RAM. BF16 necesita 40 GB.
- H3 requiere: Banderas
--disable-pinned-memory --fp16-intermediates.
- No mezclar tipos de modelos. Z-Image usa UNET/CLIP/VAE (por separado). Los puntos de control SDXL usan CheckpointLoaderSimple.
- extra_model_paths.yaml usa barras inclinadas hacia adelante:
D:/AI/models/.
- La caché de HF/Torch debe estar en D: (configurado en el bat de lanzamiento).
- Los nodos MarkdownNote pueden referenciar nombres de modelos en el texto; límpialos para evitar falsos avisos de "modelo faltante".
Instalar un modelo nuevo
- Descargar a
D:\AI\downloads\ mediante curl.
- Mover a la carpeta correcta bajo
D:\AI\models\.
- Verificar el encabezado safetensors:
D:\AI\ComfyUI\python_embeded\python.exe -c "import struct,json,sys; sys.stdout.reconfigure(encoding='utf-8'); f=open(r'<ruta>','rb'); n=struct.unpack('<Q',f.read(8))[0]; h=json.loads(f.read(n)); print('OK', len(h), 'tensores')"
- Reiniciar ComfyUI.
- Verificar que el cargador lo ve a través de
http://127.0.0.1:8188/object_info/<NodoCargador>.
- Crear flujo de trabajo a partir de una plantilla existente, actualizar tanto
widgets_values como widgets_values_named.
- Probar mediante API (ver
test_zimage.py para el patrón).
- Actualizar README y documentación.
Comandos de lanzamiento
:: Normal (imágenes, 3D, general)
D:\AI\ComfyUI\run_nvidia_gpu.bat
:: --enable-manager
:: Vídeo (MiniMax H3)
D:\AI\ComfyUI\run_nvidia_gpu_video.bat
:: --enable-manager --disable-pinned-memory --fp16-intermediates
Modelos clave y ajustes
| Modelo | Archivos | Ajustes |
|---|
| Z-Image Turbo | UNET int8 + codificador FP8 + ae.safetensors | 8-9 pasos, CFG 1.0, res_multistep, simple, 1024-1344px |
| Nova Anime XL v19 | NovaAnimeILV190.safetensors (SDXL) | 28 pasos, CFG 5, euler_ancestral, normal, CLIP skip 2 |
| Prefect Pony XL v6 | PrefectPonyXLV6.safetensors (Pony/SDXL) | 28 pasos, CFG 6, euler_ancestral, normal, CLIP skip 2 |
| Pixal3D/TRELLIS.2 | UNETs int8 + VAEs + DINOv3 + BiRefNet + MoGe | 1024px, booleano: off=Pixal3D, on=TRELLIS.2 |
| MiniMax H3 | int8 podado + codificador NVFP4 + VAEs de vídeo/audio | 5s 864x480, LoRA turbo de 4 pasos; 15s 1344x768 ~23 min |
Problemas comunes
| Problema | Solución |
|---|
hostbuf_file_reader_read falló | --disable-dynamic-vram o usar builds int8/FP8 |
Fault falló: 2 (H3) | --disable-pinned-memory --fp16-intermediates + reducir resolución |
| Pantalla negra (TDR) | Reducir resolución/pasos; aumentar el retardo TDR en el registro |
| Diálogo "Modelo faltante" | Corregir ambos campos widgets; reiniciar ComfyUI; recargar página |
| Modelo no aparece en el desplegable | Reiniciar ComfyUI (lista de modelos almacenada en caché al inicio) |
| H3 I2V falla | FL2VA no instalado; usar flujo de trabajo R2V seguro |
Archivos de documentación
D:\AI\README.txt — referencia rápida para el usuario
D:\AI\SETUP_DOCUMENTATION.md — referencia completa de 13 secciones
D:\AI\HANDOFF.md — referencia rápida para el agente (procedimientos de instalación)
D:\AI\PROJECTS.md — seguimiento de proyectos
D:\AI\projects\<slug>\README.md — documentación por proyecto
No instalado (disponible bajo solicitud)
SDXL base, FLUX, LoRAs de pixel art, ControlNet SDXL, H3 FL2VA, modelos de sobreescalado (ESRGAN/SeedVR2), LoRAs de texturas, herramientas de entrenamiento Kohya, Krita AI Diffusion, Aseprite/Pixelorama.