Instalaste ComfyUI, hiciste doble clic y en lugar de las imágenes apareció un mensaje rojo, o la ventana negra se cerró sola. Le pasa a casi todo el mundo la primera vez, y a nosotros también nos pasa de vez en cuando, después de una actualización: trabajamos con ComfyUI todos los días en una RTX 3060 de 12 GB de lo más normal y hemos visto bastantes de estos errores.
La buena noticia es que casi siempre la causa es sencilla: falta una librería de Windows, el driver es viejo o un archivo está en la carpeta equivocada. En esta guía reunimos los problemas más comunes de quien instala ComfyUI por primera vez, tanto con la versión portable como con la app Desktop, con la solución explicada paso a paso. Revisamos todo en la documentación oficial y en los reportes de los últimos meses (la guía está actualizada a noviembre de 2026, ComfyUI 0.46).
Cómo usar esta página: copia el mensaje de error que ves, presiona Ctrl+F y busca una parte aquí abajo. Los errores están escritos tal como los muestra ComfyUI.
En resumen: el error y dónde encuentras la solución
| Si ves… | Normalmente significa | Ve a |
|---|---|---|
c10.dll, WinError 126, MSVCP140.dll | Faltan las librerías Microsoft Visual C++ | Librerías de Microsoft |
Torch not compiled with CUDA enabled | Driver NVIDIA viejo o paquete equivocado | Driver NVIDIA |
no kernel image is available | Paquete que no corresponde a tu tarjeta gráfica | Paquete correcto |
| La ventana negra se cierra enseguida | Error al iniciar que no alcanzas a leer | Ventana que se cierra |
Port 8188 is already in use | ComfyUI ya está abierto | Puerto ocupado |
Nodos rojos, node types were not found | Faltan nodos personalizados | Nodos rojos |
Value not in list: ckpt_name | Falta el modelo o está en la carpeta equivocada | Modelos que faltan |
CUDA out of memory | La memoria de la tarjeta gráfica no alcanza | Memoria de vídeo |
| Imagen negra o gris | VAE equivocado o problema de precisión | Imágenes negras |
mat1 and mat2 shapes cannot be multiplied | Modelos de familias distintas mezclados | Modelos incompatibles |
| La app Desktop se abre y se cierra | Actualización de la app que quedó a medias | App que se cierra |
Antes que nada: dónde leer el error
Para resolver un problema necesitas el mensaje exacto. Dónde encontrarlo depende de cómo instalaste ComfyUI.
Versión portable. El error aparece en la ventana negra que se abre con run_nvidia_gpu.bat. Si hay una lista larga de líneas que empieza con Traceback, la línea que importa casi siempre es la última, o la primera con la palabra Error.
App Desktop. Los mensajes de la app están en el menú (las tres líneas de arriba) → Desktop Settings → Logs → Open logs folder (el archivo se llama app.log). Los de ComfyUI propiamente dicho los encuentras en la tarjeta de tu instalación: los tres puntos → Manage → pestaña Terminal.
Error en la interfaz. Si ComfyUI arranca pero un nodo se pone rojo, el mensaje aparece en un recuadro en el navegador y también en la ventana negra (o en el Terminal de la app).
Problemas de la versión portable
La versión portable es el paquete .7z que se descarga de GitHub, se extrae y se inicia con run_nvidia_gpu.bat. Es la más usada en las guías, y también la que da más problemas la primera vez, porque usa las librerías y los drivers que ya tienes en la PC.
Error "c10.dll", "WinError 126" o "MSVCP140.dll no encontrado": faltan las librerías de Microsoft
Mensajes típicos:
OSError: [WinError 126] The specified module could not be found. Error loading "...\torch\lib\c10.dll" or one of its dependencies.DLL load failed, o una ventana de Windows que dice que faltaMSVCP140.dlloVCRUNTIME140.dll
Por qué pasa: PyTorch, el motor que hace funcionar los modelos, necesita un paquete de librerías de Microsoft llamado Visual C++ Redistributable. En muchas PC ya está porque lo instalaron otros programas o juegos; en una PC nueva o recién formateada a menudo falta.
Cómo resolverlo:
- Descarga el paquete oficial de Microsoft desde esta dirección: https://aka.ms/vc14/vc_redist.x64.exe. Es el mismo enlace que ComfyUI escribe en su archivo de inicio.
- Abre el archivo descargado y haz clic en Instalar. Si te dice que ya está instalado, elige Reparar: a veces la instalación que ya tienes está dañada.
- Reinicia la computadora.
- Inicia otra vez
run_nvidia_gpu.bat.
Por ahí todavía se encuentra el enlace viejo aka.ms/vs/17/release/vc_redist.x64.exe: funciona, pero hoy Microsoft indica el de arriba. Si el error sigue después de la instalación, la causa más probable es el driver de la tarjeta gráfica (mira el punto siguiente).
"Torch not compiled with CUDA enabled" o "The NVIDIA driver on your system is too old"
Por qué pasa: El paquete portable estándar usa una versión de PyTorch para CUDA 13, que requiere un driver NVIDIA reciente (de la serie 580 o posterior). Con un driver más viejo ComfyUI no ve la tarjeta gráfica. El mismo error aparece si tienes una tarjeta AMD o Intel y descargaste el paquete de NVIDIA.
Cómo resolverlo:
- Revisa la versión del driver: presiona las teclas Windows + R, escribe
cmd, presiona Enter y en la ventana escribenvidia-smi. El número del driver está en la primera línea de arriba (por ejemplo "Driver Version: 581.xx"). - Si el número es menor que 580, instala el driver más reciente desde la app de NVIDIA o desde nvidia.com/drivers. Sirven tanto los drivers Game Ready como los Studio.
- Reinicia la PC e inicia otra vez
run_nvidia_gpu.bat. - Si tienes una tarjeta AMD o Intel Arc, el driver de NVIDIA no tiene nada que ver: descarga el paquete correcto para tu tarjeta (mira abajo).
NVIDIA no publica un número mínimo oficial para Windows: el "580" viene de la serie de drivers ligada a CUDA 13. Si tienes dudas, instala simplemente el último driver disponible.
"no kernel image is available" o "sm_61 is not compatible": el paquete no corresponde a tu tarjeta
Mensajes típicos: NVIDIA GeForce GTX 1060 with CUDA capability sm_61 is not compatible with the current PyTorch installation y luego CUDA error: no kernel image is available for execution on the device. Con las RTX serie 50 el número pasa a ser sm_120.
Por qué pasa: Desde la página de descargas de ComfyUI se pueden descargar paquetes distintos, y cada uno funciona solo con ciertas tarjetas. El paquete estándar ya no es compatible con las tarjetas GTX serie 10 y anteriores; el paquete para tarjetas viejas, en cambio, no es compatible con las RTX serie 50.
Qué paquete descargar (desde la página de releases de ComfyUI en GitHub):
| Tu tarjeta gráfica | Archivo que debes descargar |
|---|---|
| NVIDIA RTX 20, 30, 40, 50 y GTX 16 | ComfyUI_windows_portable_nvidia.7z |
| NVIDIA GTX 10 (1060, 1070, 1080…) y anteriores | ComfyUI_windows_portable_nvidia_cu126.7z |
| AMD Radeon RX 6000, 7000, 9000 | ComfyUI_windows_portable_amd.7z (se inicia con run_amd_gpu.bat) |
| Intel Arc | ComfyUI_windows_portable_intel.7z (se inicia con run_intel_gpu.bat) |
Cómo resolverlo:
- Revisa qué tarjeta tienes: presiona Ctrl + Mayús + Esc para abrir el Administrador de tareas, ve a Rendimiento y haz clic en GPU. El nombre de la tarjeta está arriba a la derecha.
- Descarga el paquete correcto según la tabla.
- Extráelo en una carpeta nueva (mira los consejos de abajo) e inicia el archivo
.batcorrespondiente. - Con las RTX serie 50 no vuelvas a usar un paquete portable viejo, descargado antes de 2025: no incluye soporte para estas tarjetas.
La extracción del archivo .7z no funciona o faltan carpetas
Síntomas: 7-Zip muestra Data error o Cannot open the file as archive, o al iniciar ComfyUI aparece '.\python_embeded\python.exe' is not recognized.
Por qué pasa: El archivo pesa unos 2 GB: si la descarga se cortó, está incompleto. O bien Windows bloqueó el archivo porque viene de internet.
Cómo resolverlo:
- Compara el tamaño del archivo descargado con el que indica GitHub. Si es distinto, descárgalo de nuevo.
- Instala 7-Zip, que es gratis: las versiones viejas del Explorador de archivos no abren bien los
.7z. - Si la extracción sigue fallando: clic derecho en el archivo
.7z→ Propiedades → abajo marca Desbloquear (Unblock) → Aceptar. - Extrae con clic derecho → 7-Zip → Extraer aquí, en una carpeta con una ruta corta.
- Revisa que adentro estén las carpetas
ComfyUI,python_embededyupdatey el archivorun_nvidia_gpu.bat.
Dónde poner la carpeta de ComfyUI
Muchos problemas raros (archivos que desaparecen, errores de permisos, nodos que no se instalan) vienen de la ubicación de la carpeta. Nuestro consejo:
- usa una ruta corta en un disco local, por ejemplo
C:\AI\ComfyUI_windows_portableoD:\AI\...; - evita el Escritorio, Documentos y Descargas si en la PC está activo OneDrive, porque esas carpetas se sincronizan con la nube;
- si al instalar nodos aparece el error
Filename too long, es porque Windows tiene un límite de 260 caracteres para las rutas: mover la carpeta más arriba (por ejemplo directamente aC:\AI) normalmente es suficiente.
Para quien tiene más práctica, también existe una opción de Windows que quita el límite de las rutas largas (Directivas de grupo → "Habilitar rutas de acceso largas de Win32"), pero necesita acceso de administrador, y para un principiante es más fácil mover la carpeta.
La ventana negra se abre y se cierra enseguida
Por qué pasa: Hay un error al iniciar, pero la ventana se cierra antes de que puedas leerlo. El archivo run_nvidia_gpu.bat original termina con un comando que mantiene la ventana abierta: si se cierra igual, normalmente es porque copiaste el archivo .bat en otra carpeta (por ejemplo en el Escritorio) o lo modificaste.
Cómo resolverlo:
- Abre la carpeta de ComfyUI portable.
- Haz clic en la barra de direcciones de arriba en el Explorador de archivos, escribe
cmdy presiona Enter: se abre una ventana que ya está en la carpeta correcta. - Escribe
run_nvidia_gpu.baty presiona Enter. Ahora la ventana queda abierta y puedes leer el error. - Si quieres iniciar ComfyUI desde el Escritorio, no copies el archivo
.bat: crea un acceso directo (clic derecho en el archivo → Mostrar más opciones → Crear acceso directo) y mueve ese. El archivo.batsolo funciona desde su carpeta.
"Port 8188 is already in use"
El mensaje completo es Port 8188 is already in use on address 127.0.0.1. Please close the other application or use a different port with --port.
Por qué pasa: ComfyUI ya está abierto, por ejemplo porque hiciste doble clic dos veces, o también está abierta la app Desktop.
Cómo resolverlo:
- Cierra todas las ventanas negras de ComfyUI y la app Desktop, si la tienes abierta.
- Si el error sigue, abre el Administrador de tareas (Ctrl + Mayús + Esc), busca los procesos
python.exeque quedaron abiertos y ciérralos con Finalizar tarea. - Si quieres usar dos ComfyUI a la vez, haz una copia del archivo
.bat, ábrela con clic derecho → Editar y agrega--port 8189al final de la primera línea. Después abrehttp://127.0.0.1:8189en el navegador.
Cómo resolverlo:
- Espera a que en la ventana negra aparezca la línea
To see the GUI go to: http://127.0.0.1:8188. - Abre Chrome o Edge y escribe a mano
http://127.0.0.1:8188. - Actualiza el navegador: la documentación oficial indica como mínimo Chrome 143, y con versiones viejas la interfaz puede no cargar.
- Si usas una VPN o un proxy de empresa, prueba a desactivarlos.
No aparece el Manager: no puedo instalar nodos
Por qué pasa: Desde diciembre de 2025 el ComfyUI Manager (la herramienta para instalar nodos y modelos) viene integrado en ComfyUI, pero en la versión portable está apagado: hay que instalarlo y activarlo una vez. Muchas guías viejas dicen que lo descargues con git clone en la carpeta custom_nodes: todavía funciona, pero hoy el método oficial es este.
Cómo resolverlo:
- En la carpeta principal de ComfyUI portable crea un archivo de texto y llámalo
instalar_manager.bat(fíjate en que la extensión sea.baty no.txt). - Ábrelo con el Bloc de notas y escribe dos líneas: en la primera
.\python_embeded\python.exe -m pip install -r ComfyUI\manager_requirements.txt, en la segundapause. Luego guarda. - Haz doble clic en
instalar_manager.baty espera a que termine. - Haz una copia de
run_nvidia_gpu.baty ponle un nombre, por ejemploiniciar_con_manager.bat. - Clic derecho en la copia → Editar, y cambia la primera línea así:
.\python_embeded\python.exe -s ComfyUI\main.py --windows-standalone-build --enable-manager - De ahora en adelante inicia ComfyUI con
iniciar_con_manager.bat. En la interfaz encuentras el Manager en el ícono del rompecabezas o en el menú → Manage Extensions.
En la app Desktop el Manager ya está activo, no tienes que hacer nada.
El antivirus borra archivos
Si después de la extracción faltan archivos o Windows muestra "Amenaza en cuarentena", abre Seguridad de Windows → Protección antivirus y contra amenazas → Historial de protección y mira qué archivo se bloqueó. Restáuralo solo si forma parte del paquete oficial descargado de github.com/Comfy-Org. No desactives el antivirus para toda la carpeta: los nodos personalizados son código de terceros, y en el pasado algunos sí contenían software malicioso.
Problemas de la app Desktop
Cuidado con las guías viejas: en 2026 la app oficial se rehízo desde cero y hoy se llama Comfy Desktop (versión 1.x). Tiene una pantalla de inicio con tus instalaciones, llamadas "instancias", y guardados automáticos. La página de mantenimiento, el botón "Reinstall" y las comprobaciones de Git y Visual C++ que aparecen en muchos tutoriales pertenecen a la app vieja, que ahora se llama Legacy Desktop.
La app se descarga desde comfy.org/download. En Windows funciona con tarjetas NVIDIA, y también hay versiones para AMD (RX 6000 y posteriores), Intel Arc y solo procesador. En la Mac requiere un chip Apple Silicon (M1 o posteriores) con macOS 13 o más reciente: las Mac con procesador Intel no son compatibles.
La app se abre un segundo y se cierra (después de una actualización)
Por qué pasa: La actualización automática de la app se detuvo a medias. Es un problema conocido de las versiones hasta la 1.0.46.
Cómo resolverlo:
- Descarga el instalador más reciente desde comfy.org/download.
- Ejecútalo encima de la app que ya tienes, sin desinstalarla antes: instalaciones, modelos y configuración se quedan en su lugar.
- Si no alcanza, esta es una solución que reportan varios usuarios pero que no es oficial: cierra la app, abre con el Bloc de notas el archivo
%APPDATA%\Comfy Desktop\settings.json(pega la ruta en la barra del Explorador de archivos) y cambia"installUpdatesOnStartup": trueporfalse. Guarda y vuelve a abrir la app.
La app no se abre para nada
- En Windows: clic derecho en el ícono → Ejecutar como administrador, solo la primera vez.
- En la Mac: Configuración del Sistema → Privacidad y seguridad → abajo haz clic en Abrir igualmente.
- Asegúrate de tener la última versión de la app.
"This file was blocked by application control policy" (Windows 11)
Mensajes típicos: ImportError: DLL load failed while importing ...: This file was blocked by application control policy.
Por qué pasa: En algunas PC con Windows 11 está activo Smart App Control, una protección que bloquea los archivos que no tienen firma digital, y algunas librerías de Python no la tienen.
Qué hay que saber: Por ahora (noviembre de 2026) no existe una solución oficial: el problema ya se reportó a los desarrolladores. La única forma de hacerlo funcionar es desactivar Smart App Control en Seguridad de Windows → Control de aplicaciones y navegador → Configuración de Smart App Control. Es una protección de seguridad, y una vez desactivada Windows solo deja volver a activarla reinstalando el sistema: decide tú si vale la pena, o usa la versión portable.
La primera descarga se traba o aparece "ERR_CONNECTION_RESET"
Por qué pasa: En la primera instalación la app descarga varios GB (el entorno de Python y PyTorch). Si la conexión se corta, la descarga falla.
Cómo resolverlo:
- Usa una conexión estable, mejor por cable; desactiva la VPN y el punto de acceso del celular.
- Vuelve a intentar crear la instalación: la app reutiliza la parte ya descargada.
- Revisa en el menú (las tres líneas de arriba) → Desktop Settings → Advanced que PyPI Mirror URL esté vacío y Use Chinese Mirrors apagado (solo sirven desde China).
Pantalla "Operation failed"
- Presiona Reboot (o Restart ComfyUI) para volver a intentarlo.
- Si sigue fallando, abre los logs (el menú (las tres líneas de arriba) → Desktop Settings → Logs) y la pestaña Terminal en Manage para leer el error real, y después búscalo en esta página.
- Si la instalación sigue rota: los tres puntos en su tarjeta → Uninstall, y luego crea una instalación nueva con New Instance. Los modelos están en una carpeta compartida y no se borran.
"Torch not compiled with CUDA enabled" o "access violation" al iniciar la app
- Actualiza la app a la última versión.
- Actualiza el driver NVIDIA: la misma app muestra un aviso si el driver es más viejo que la serie 580.
- Si el error sigue: los tres puntos → Manage → pestaña Update → en la sección PyTorch elige otra versión y presiona Change PyTorch. Con Copy & Change PyTorch haces la prueba en una copia, sin tocar la instalación original.
Tengo una tarjeta GTX serie 10
Con las GTX 1060, 1070, 1080 y similares aparece el aviso "needs compute capability 7.5" o, al generar, no kernel image is available. En Manage → Update → PyTorch elige la versión cu126 (la de las tarjetas más viejas) y presiona Change PyTorch.
No puedo elegir la carpeta de instalación
Si el botón Continue queda gris, la app está rechazando la carpeta que elegiste: no acepta carpetas de OneDrive ni carpetas que ya usa otra instalación. Elige una carpeta normal en un disco local, por ejemplo D:\ComfyUI-Installs. La carpeta predeterminada se cambia en el menú (las tres líneas de arriba) → Desktop Settings → Advanced → Default Install Location.
Dónde están mis archivos en la app Desktop
| Qué | Windows | Mac |
|---|---|---|
| Instalaciones | %LOCALAPPDATA%\Comfy-Desktop\ComfyUI-Installs | ~/ComfyUI-Installs |
| Modelos, input y output compartidos | %LOCALAPPDATA%\Comfy-Desktop\ComfyUI-Shared | ~/ComfyUI-Shared |
| Configuración y logs | %APPDATA%\Comfy Desktop | ~/Library/Application Support/Comfy Desktop |
Para abrir estas carpetas en Windows, pega la ruta en la barra de direcciones del Explorador de archivos. Si ya tenías una versión portable, puedes agregarla a la app desde el menú (las tres líneas de arriba) → Add Existing Instance, sin copiar nada.
El primer workflow: nodos rojos y modelos que faltan
ComfyUI arranca, cargas un workflow descargado de internet y algo se pone rojo. Son los problemas más frecuentes de todos, y los más fáciles de resolver.
"When loading the graph, the following node types were not found"
Por qué pasa: El workflow usa nodos personalizados (extensiones creadas por la comunidad) que no están instalados en tu ComfyUI.
Cómo resolverlo:
- Asegúrate de que el Manager esté activo (en la portable hay que activarlo, mira arriba).
- Cuando cargas el workflow, ComfyUI te propone instalar los nodos que faltan: elige Install All, u Open Manager para verlos uno por uno.
- Al terminar, cierra y reinicia ComfyUI por completo (no basta con recargar la página), y luego vuelve a cargar el workflow.
- Si algunos nodos siguen rojos, mira en la ventana negra si aparece
IMPORT FAILED(mira el punto siguiente).
"IMPORT FAILED": el nodo está instalado pero no se carga
Por qué pasa: Al nodo le falta una librería de Python o choca con otra extensión o con tu versión de ComfyUI.
Cómo resolverlo:
- En la ventana negra, sube por encima de la línea
IMPORT FAILED: el primer error que encuentres (normalmenteModuleNotFoundError: No module named ...) es la causa real. - En el Manager actualiza ese nodo. Si aparece el botón Try Fix, úsalo: reinstala las librerías del nodo.
- Para saber si el problema es un nodo personalizado, inicia ComfyUI sin extensiones: en la portable haz una copia del
.baty agrega--disable-all-custom-nodesa la primera línea. Si así funciona, la culpable es una de las extensiones. - Si un nodo sigue dando problemas, desactívalo desde el Manager y busca una alternativa.
"This action is not allowed with this security level configuration"
Por qué pasa: El Manager tiene un nivel de seguridad que bloquea algunas instalaciones que considera riesgosas, por ejemplo desde una dirección de GitHub o desde fuera del catálogo oficial.
Cómo resolverlo:
- En la portable abre el archivo
ComfyUI\user\__manager\config.inicon el Bloc de notas (en las versiones más viejas está enComfyUI\user\default\ComfyUI-Manager\config.ini; la ruta exacta aparece en la ventana negra al iniciar). - Cambia la línea
security_level = normalporsecurity_level = weak, guarda y reinicia ComfyUI. - Instala lo que necesitas y después **vuelve a poner
normal**: el nivelweakpermite todo, incluso instalaciones que pueden ser peligrosas. - En la app Desktop lo mismo se hace desde Manage → Startup Args → Manager Security Level.
"Value not in list: ckpt_name": falta el modelo
Mensaje típico: Prompt outputs failed validation: CheckpointLoaderSimple: Value not in list: ckpt_name: 'nombre_modelo.safetensors' not in []
Por qué pasa: ComfyUI no trae modelos: hay que descargarlos aparte. O el modelo está, pero en la carpeta equivocada, o el workflow busca un archivo con un nombre distinto del tuyo.
En qué carpeta va cada modelo (dentro de ComfyUI\models):
| Tipo de archivo | Carpeta |
|---|---|
| Checkpoints completos (SD 1.5, SDXL…) | checkpoints |
| Modelos de difusión separados (Flux, Wan, Qwen-Image…) y archivos GGUF | diffusion_models (también sirve la vieja unet) |
| Codificadores de texto (CLIP, T5, Qwen…) | text_encoders (también sirve la vieja clip) |
| VAE | vae |
| LoRA | loras |
| Upscaler | upscale_models |
| ControlNet | controlnet |
Cómo resolverlo:
- Pon el archivo en la carpeta que indica la tabla.
- En la interfaz presiona la tecla R para actualizar la lista de modelos, o reinicia.
- Haz clic en el nodo rojo y elige el archivo en el menú desplegable: los workflows descargados llevan el nombre del archivo del autor, que puede ser distinto del tuyo.
- En la app Desktop los modelos van en la carpeta compartida (
ComfyUI-Shared\models), no en la carpeta del programa.
El botón "Download" de los modelos que faltan no hace nada
Cuando abres un modelo desde los Template de ComfyUI, aparece la lista de los modelos que faltan con el botón para descargarlos. A veces no funciona: es un problema conocido, reportado a los desarrolladores y todavía sin resolver.
Cómo resolverlo:
- En la app Desktop vuelve a intentarlo desde el recuadro Downloads de arriba.
- Si no, descarga el archivo a mano desde la página de Hugging Face y ponlo en la carpeta que indica la tabla de arriba.
- En Hugging Face usa el botón de descarga de la página del archivo: la dirección correcta contiene
/resolve/main/. Si la dirección contiene/blob/main/, estás descargando la página web y no el modelo.
Un workflow descargado de internet no se abre
El workflow va guardado dentro de las imágenes PNG originales y en los archivos .json. Si arrastras una imagen y solo aparece un nodo "Load Image", esa imagen no contiene el workflow: muchos sitios y redes sociales convierten las imágenes a JPG o WebP y borran los datos. Busca el archivo .json o el PNG original, y ábrelo desde el menú File → Open en lugar de arrastrarlo. Después de abrirlo pueden faltar nodos y modelos: mira los puntos de arriba.
Memoria y velocidad
"CUDA out of memory" o "Allocation on device"
Por qué pasa: El modelo, junto con la resolución, la cantidad de imágenes o la duración del vídeo, necesita más memoria de la que tiene tu tarjeta gráfica.
Cómo resolverlo, en este orden:
- Baja la resolución, la cantidad de imágenes por tanda (batch size) o la duración del vídeo.
- Cierra los demás programas que usan la tarjeta gráfica: navegador con muchas pestañas, juegos, editores de vídeo.
- Usa una versión más liviana del modelo: fp8 o GGUF (archivos comprimidos que ocupan menos memoria, se cargan con la extensión ComfyUI-GGUF).
- Deja un poco de memoria libre para Windows agregando
--reserve-vram 2a la primera línea del archivo.bat(en la app Desktop: Manage → Startup Args).
Desde marzo de 2026 ComfyUI administra la memoria de vídeo de forma automática (Dynamic VRAM) en las tarjetas NVIDIA. Por eso el viejo consejo de "agregar --lowvram" hoy, por sí solo, ya no hace nada: funciona solo junto con --disable-dynamic-vram. Prueba primero los puntos de arriba.
En una tarjeta de 12 GB como nuestra RTX 3060, con los modelos en fp8 o GGUF se hacen sin problema imágenes con Flux y vídeos cortos: si quieres entender cuánta memoria hace falta para cada cosa, encuentras los detalles en nuestra guía de tarjetas gráficas para IA. Para el vídeo, en nuestra guía de modelos de IA para vídeo en ComfyUI encontrarás cuánta memoria necesita cada modelo.
"The paging file is too small" (WinError 1455)
Por qué pasa: Aquí la tarjeta gráfica no tiene nada que ver, porque se acabó la RAM de la computadora. Windows usa una parte del disco como memoria adicional (el archivo de paginación), y el tamaño configurado es demasiado chico para cargar un modelo grande.
Cómo resolverlo:
- Presiona Windows + R, escribe
sysdm.cply presiona Enter. - Pestaña Opciones avanzadas → en la sección Rendimiento haz clic en Configuración → pestaña Opciones avanzadas → Memoria virtual → Cambiar.
- Quita la marca de "Administrar automáticamente", selecciona el disco más rápido (mejor un SSD con espacio libre), elige Tamaño personalizado y pon por ejemplo 32768 MB tanto en el tamaño inicial como en el máximo.
- Haz clic en Establecer, Aceptar y reinicia la PC.
En cambio, agrandar el archivo de paginación no resuelve un error CUDA out of memory, que tiene que ver con la tarjeta gráfica.
Si el error vuelve a menudo, tu computadora tiene poca RAM para los modelos que usas. Nosotros trabajamos con 32 GB, y en la página Configuraciones de PC 2026 encontrarás las computadoras que recomendamos para la IA.
ComfyUI va lentísimo: está usando el procesador
Si una imagen tarda muchos minutos y en el Administrador de tareas la tarjeta gráfica no trabaja, ComfyUI está usando el procesador en lugar de la tarjeta. En la ventana negra, al iniciar, aparece Device: cpu.
- Inicia ComfyUI con
run_nvidia_gpu.bat, no conrun_cpu.bat(desde la versión 0.45 se movió a la carpetaadvanced). - Revisa si PyTorch ve la tarjeta: abre
cmden la carpeta de ComfyUI portable y escribe.\python_embeded\python.exe -c "import torch; print(torch.cuda.is_available())". Si respondeFalse, actualiza el driver (mira arriba) o vuelve a descargar el paquete correcto.
Sage Attention, Triton, xformers: no los necesitas
Muchos vídeos prometen generaciones más rápidas con Sage Attention, Triton o xformers. Son optimizaciones opcionales, delicadas de instalar en Windows, y están entre las causas más frecuentes de que ComfyUI deje de arrancar (por ejemplo con No module named 'sageattention'). Si acabas de instalar ComfyUI, déjalas de lado. Si las agregaste y algo no funciona, quita --use-sage-attention del archivo .bat y ComfyUI vuelve a funcionar con el método estándar.
Imágenes equivocadas y archivos dañados
Imágenes negras o grises
Por qué pasa: Una imagen toda negra, sin errores, normalmente viene de un problema de precisión de los cálculos en el VAE (la parte que convierte el resultado en una imagen de verdad). Una imagen gris o marrón muchas veces indica un VAE que no es el correcto para el modelo.
Cómo resolverlo:
- Usa el VAE que corresponde al modelo: para SDXL el archivo recomendado es
sdxl_vae_fp16_fix.safetensors, para Fluxae.safetensors. - Prueba a agregar
--fp32-vaea la primera línea del archivo.bat: hace que el VAE trabaje con más precisión. Cuidado, en algunas guías aparece--force-fp32-vae, que no existe. - Si todavía no funciona, parte de un template oficial de ComfyUI para ese modelo: tiene la combinación correcta de archivos.
"mat1 and mat2 shapes cannot be multiplied"
Errores parecidos: expected input ... to have 4 channels, but got 16 channels instead, The size of tensor a must match the size of tensor b.
Por qué pasa: Estás usando juntos archivos de familias distintas: por ejemplo un VAE de SDXL con un modelo Flux, una LoRA de SD 1.5 con un modelo SDXL, o el codificador de texto equivocado.
Cómo resolverlo:
- Usa modelo, VAE, codificador de texto, LoRA y ControlNet de la misma familia (SD 1.5, SDXL, Flux, Qwen-Image…).
- Si el error habla de 4 y 16 canales: SD 1.5 y SDXL trabajan con 4 canales, Flux y SD3 con 16. Mezclaste las dos familias.
- La forma más segura: abre el template oficial del modelo desde el menú Template de ComfyUI y cambia solo lo que necesitas.
Para saber qué archivos necesita cada modelo, encuentras la lista completa en nuestra guía de modelos de IA para imágenes en ComfyUI.
"Error while deserializing header" (HeaderTooLarge)
Por qué pasa: El archivo del modelo está dañado o incompleto. A veces es directamente una página web guardada con el nombre .safetensors. Pasa cuando se descarga de Hugging Face la dirección de la página en lugar de la del archivo, o desde una página que pide iniciar sesión.
Cómo resolverlo:
- Mira el tamaño del archivo: si pesa pocos KB en lugar de varios GB, es una página web.
- Descárgalo de nuevo con el botón de descarga (dirección con
/resolve/main/). Para los modelos que piden aceptar una licencia, inicia sesión en Hugging Face y acéptala antes. - Prefiere siempre los archivos
.safetensorsa los.ckpty.pt, que pueden contener código ejecutable.
Después de una actualización algo dejó de funcionar
Qué archivo usar para actualizar la portable
En la carpeta update de la portable hay tres archivos:
| Archivo | Qué hace | Cuándo usarlo |
|---|---|---|
update_comfyui_stable.bat | Actualiza a la última versión estable | Nuestro consejo para principiantes |
update_comfyui.bat | Actualiza a la última versión en desarrollo | Si necesitas una novedad recién salida |
update_comfyui_and_python_dependencies.bat | Actualiza también PyTorch y todas las librerías | Solo si aparecen errores de librerías: es una descarga grande |
Antes de una actualización importante haz una copia de la carpeta de ComfyUI (o por lo menos de ComfyUI\custom_nodes y ComfyUI\user): si algo se rompe, vuelves atrás en un momento.
Errores con NumPy después de una actualización
Mensajes típicos: A module that was compiled using NumPy 1.x cannot be run in NumPy 2.x o numpy.core.multiarray failed to import.
Por qué pasa: Una actualización o un nodo nuevo cambió la versión de NumPy (una librería de cálculo) y una extensión más vieja no es compatible con ella.
Cómo resolverlo:
- Actualiza desde el Manager el nodo que da error: muchas veces el autor ya lo arregló.
- Si no alcanza, desactiva ese nodo o vuelve a la copia de antes de la actualización.
- No cambies a mano la versión de NumPy si el autor del nodo no te lo pide: puedes romper otras extensiones.
Interfaz rota o vieja después de la actualización
Síntomas: página en blanco o gris, menús fuera de lugar, o en la ventana negra el aviso Installed comfyui-frontend-package version ... is lower than the recommended version.
- Recarga la página vaciando la caché del navegador: Ctrl + F5.
- En la portable vuelve a ejecutar
update\update_comfyui.bat: también actualiza la interfaz. - Si el problema sigue, en Settings → Extensions desactiva las extensiones de terceros y vuelve a activarlas de a una para encontrar la que molesta.
- Si tu portable tiene muchos meses o años, actualizar no alcanza: descarga un paquete nuevo y mueve adentro las carpetas
ComfyUI\models,ComfyUI\output,ComfyUI\usery los nodos que necesitas.
Volver a la versión anterior
- App Desktop: Manage → Snapshots. La app guarda sola una copia antes y después de cada actualización (los modelos no están incluidos): restaura la anterior. La próxima vez usa Copy & Update para probar la actualización en una copia.
- Portable: si hiciste la copia de la carpeta, vuelve a ponerla en su lugar. Si no, el Manager guarda "instantáneas" de los nodos instalados que se pueden restaurar.
Si nada funciona: empezar de nuevo sin perder los modelos
A veces el camino más rápido es una instalación limpia, y los modelos (que son la parte pesada) no hace falta volver a descargarlos.
- Portable: descarga un paquete nuevo, extráelo en una carpeta distinta y mueve a la carpeta nueva
ComfyUI\models,ComfyUI\outputyComfyUI\user(ahí están los workflows y la configuración). Los nodos personalizados reinstálalos desde el Manager en lugar de copiarlos. - App Desktop: crea una instalación nueva con New Instance: los modelos están en la carpeta compartida y la instalación nueva los ve enseguida.
- Modelos en una sola carpeta para varias instalaciones: en la portable copia el archivo
extra_model_paths.yaml.example, cámbiale el nombre aextra_model_paths.yamly escribe adentro la ruta de tu carpeta de modelos. En la app Desktop se hace desde el menú (las tres líneas de arriba) → Desktop Settings → Storage → Add Shared Directory.
Si todavía estás decidiendo cómo instalar ComfyUI, en nuestra guía para instalar ComfyUI en Windows encuentras los dos métodos explicados desde cero, y en la página ComfyUI: todos nuestros tutoriales todo lo demás.
Preguntas frecuentes
¿Qué conviene más para evitar problemas, la versión portable o la app Desktop?
Para quien empieza, hoy la app Desktop da menos problemas: instala PyTorch sola, trae el Manager ya activo y guarda una copia antes de cada actualización. También el sitio oficial de ComfyUI recomienda la app a los usuarios comunes. La portable sigue siendo útil para quien quiere todo en una carpeta, quizás en un disco externo, y para las tarjetas AMD e Intel.
¿Por qué ComfyUI dice que falta un modelo que ya descargué?
Casi siempre el archivo está en la carpeta equivocada o tiene un nombre distinto del que aparece en el workflow. Revisa la tabla de carpetas de esta guía, presiona R en la interfaz para actualizar la lista y elige el archivo en el menú desplegable del nodo.
¿ComfyUI funciona sin una tarjeta NVIDIA?
Sí: hay paquetes para AMD (RX 6000 y posteriores) e Intel Arc, y en la Mac funciona con los chips Apple Silicon. Sin una tarjeta gráfica dedicada ComfyUI arranca igual, pero usando solo el procesador es muy lento, sobre todo con los modelos recientes. Si tu computadora no alcanza, en la comparativa imágenes con IA: ¿en local u online? también encontrarás las alternativas online.
¿Tengo que instalar Python o Git para usar ComfyUI?
No. Tanto la portable como la app Desktop ya traen su propio Python. Git no hace falta para el uso normal: solo puede servir para instalar algunos nodos directamente desde una dirección de GitHub.










