CommunityImagengithub.com

Configuración de ComfyUI

Instalación local de ComfyUI, gestión de modelos, flujos de trabajo y resolución de problemas para generación de IA de imágenes/vídeo/3D en Windows con RTX 3090.

¿Qué es Configuración de ComfyUI?

Este skill detalla la configuración completa de un entorno local de ComfyUI para generación de imágenes, vídeo y 3D con IA, optimizado para una máquina Windows 10 Pro con RTX 3090 de 24 GB VRAM y 28 GB de RAM (ampliables a 40 GB). Proporciona la estructura de carpetas, ubicaciones de modelos, atajos de lanzamiento para casos de uso normal y de vídeo (MiniMax H3), y una tabla completa de tipos de modelo con sus cargadores correspondientes. Incluye reglas críticas como la necesidad de actualizar tanto `widgets_values` como `widgets_values_named` al cambiar nombres de modelos, reiniciar ComfyUI después de añadir modelos, limpiar caché del navegador si aparecen falsos avisos de modelo faltante, y usar builds int8/FP8 para limitaciones de RAM. También cubre la instalación paso a paso de nuevos modelos con verificación de integridad de safetensors, y documenta modelos clave como Z-Image Turbo, Nova Anime XL, Prefect Pony XL, Pixal3D/TRELLIS.2 y MiniMax H3, incluyendo sus ajustes de inferencia. Finalmente, enumera problemas comunes (como errores de VRAM, pantalla negra TDR o fallos de H3) con sus soluciones, y referencia los archivos de documentación local como README.txt, SETUP_DOCUMENTATION.md y HANDOFF.md.

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

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

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

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

TipoCarpetaCargador
Punto de control SDXLD:\AI\models\checkpoints\CheckpointLoaderSimple
Modelo de difusión (UNET)D:\AI\models\diffusion_models\UNETLoader
Codificador de textoD:\AI\models\text_encoders\CLIPLoader
VAED:\AI\models\vae\VAELoader
ControlNet/parcheD:\AI\models\model_patches\ModelPatchLoader
LoRAD:\AI\models\loras\LoraLoader
CLIP visionD:\AI\models\clip_vision\CLIPVisionLoader
SobreescaladoD:\AI\models\upscale_models\UpscaleModelLoader
Eliminación de fondoD:\AI\models\background_removal\LoadBackgroundRemovalModel
3DD:\AI\models\diffusion_models\ + vae\Nodos 3D nativos

Reglas críticas

  1. 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.
  2. Reiniciar ComfyUI después de añadir modelos (la lista de modelos se almacena en caché al inicio).
  3. Caché del navegador: Si aparece "modelo faltante", recargar la página (F5) y reabrir el flujo de trabajo.
  4. Builds int8/FP8 requeridos para 28 GB RAM. BF16 necesita 40 GB.
  5. H3 requiere: Banderas --disable-pinned-memory --fp16-intermediates.
  6. No mezclar tipos de modelos. Z-Image usa UNET/CLIP/VAE (por separado). Los puntos de control SDXL usan CheckpointLoaderSimple.
  7. extra_model_paths.yaml usa barras inclinadas hacia adelante: D:/AI/models/.
  8. La caché de HF/Torch debe estar en D: (configurado en el bat de lanzamiento).
  9. Los nodos MarkdownNote pueden referenciar nombres de modelos en el texto; límpialos para evitar falsos avisos de "modelo faltante".

Instalar un modelo nuevo

  1. Descargar a D:\AI\downloads\ mediante curl.
  2. Mover a la carpeta correcta bajo D:\AI\models\.
  3. 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')"
    
  4. Reiniciar ComfyUI.
  5. Verificar que el cargador lo ve a través de http://127.0.0.1:8188/object_info/<NodoCargador>.
  6. Crear flujo de trabajo a partir de una plantilla existente, actualizar tanto widgets_values como widgets_values_named.
  7. Probar mediante API (ver test_zimage.py para el patrón).
  8. 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

ModeloArchivosAjustes
Z-Image TurboUNET int8 + codificador FP8 + ae.safetensors8-9 pasos, CFG 1.0, res_multistep, simple, 1024-1344px
Nova Anime XL v19NovaAnimeILV190.safetensors (SDXL)28 pasos, CFG 5, euler_ancestral, normal, CLIP skip 2
Prefect Pony XL v6PrefectPonyXLV6.safetensors (Pony/SDXL)28 pasos, CFG 6, euler_ancestral, normal, CLIP skip 2
Pixal3D/TRELLIS.2UNETs int8 + VAEs + DINOv3 + BiRefNet + MoGe1024px, booleano: off=Pixal3D, on=TRELLIS.2
MiniMax H3int8 podado + codificador NVFP4 + VAEs de vídeo/audio5s 864x480, LoRA turbo de 4 pasos; 15s 1344x768 ~23 min

Problemas comunes

ProblemaSolució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 desplegableReiniciar ComfyUI (lista de modelos almacenada en caché al inicio)
H3 I2V fallaFL2VA 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.

Individual skills in this repo

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

Skills relacionados