Cuando ComfyUI deja de funcionar casi nunca es por una sola razon. El programa junta tres piezas independientes (el entorno de Python, el backend que carga los modelos y la interfaz web que corre en el navegador), y cada una falla de forma distinta. Diagnosticar sin separarlas es perder la tarde reinstalando cosas que estaban bien.
Respuesta corta: aisla la capa que falla antes de tocar nada. Si la consola muestra errores, el problema es Python o los modelos. Si la consola esta limpia pero el navegador queda en blanco, es la interfaz o el puerto. Si todo carga y la generacion muere a mitad, casi siempre es memoria o un custom node roto.
Lo primero: separa el fallo en tres capas
Abre la ventana de consola desde la que se lanza ComfyUI y dejala visible. Esa ventana es el unico lugar donde el programa dice la verdad. La interfaz web puede quedarse congelada mostrando un estado antiguo mientras el backend ya se cayo, asi que juzgar por lo que ves en el navegador es la principal fuente de diagnosticos equivocados.
La capa uno es el entorno: Python, PyTorch y los drivers de la tarjeta grafica. Si esta capa falla, ComfyUI ni siquiera llega a imprimir la linea que indica en que direccion local esta escuchando. La capa dos es la carga de recursos: checkpoints, VAE, LoRA y custom nodes. Aqui el servidor arranca pero escupe advertencias y el selector de modelos aparece vacio. La capa tres es la ejecucion: todo carga, la interfaz responde y el fallo ocurre al pulsar la generacion.
Antes de seguir, comprueba algo tonto que resuelve una parte enorme de los casos: que no tengas dos instancias abiertas. Si lanzaste ComfyUI, cerraste la pestaña sin cerrar la consola y volviste a lanzarlo, la segunda instancia no puede tomar el mismo puerto y se queda a medias. Cierra todas las consolas y arranca una sola vez.
ComfyUI no arranca: la consola se cierra sola
El sintoma clasico es una ventana negra que aparece medio segundo y desaparece. Eso significa que el proceso murio con un error y la consola se cerro antes de que pudieras leerlo. La solucion es lanzarlo de forma que la ventana permanezca abierta: abre primero una terminal, muevete a la carpeta de ComfyUI y ejecuta el comando de arranque desde ahi. Ahora el error se queda en pantalla.
Los tres motivos mas frecuentes de muerte instantanea son un entorno virtual que dejo de existir o quedo corrupto, una version de PyTorch que no coincide con la version de Python instalada, y un custom node que revienta durante la importacion. El tercer caso es facil de identificar porque el error menciona el nombre de la carpeta del nodo.
Cuando el entorno de Python es el culpable
Si actualizaste Python del sistema o moviste la carpeta de ComfyUI a otra unidad, el entorno virtual apunta a rutas que ya no existen. No intentes reparar rutas a mano. Recrea el entorno virtual desde cero y reinstala las dependencias. Es mas rapido y deja el estado limpio. Si usas la version portable, la reinstalacion equivale a descomprimir de nuevo el paquete y copiar tus carpetas de modelos y workflows.
Un detalle que cuesta horas: los antivirus agresivos ponen en cuarentena binarios de PyTorch por comportamiento sospechoso durante la primera carga. Si el arranque funcionaba y dejo de hacerlo sin que tocaras nada, revisa el historial de cuarentena antes de reinstalar. Nuestra guia de instalacion de ComfyUI paso a paso cubre el orden correcto de instalacion para no repetir el mismo error.
Arranca pero el navegador se queda en blanco
Si la consola muestra que el servidor esta escuchando y la pestaña del navegador aparece vacia o con un spinner eterno, el backend esta vivo y el problema es de red local o de cache. Prueba en este orden. Primero, abre la direccion local en una ventana de incognito. Eso descarta extensiones del navegador, que son responsables de muchos bloqueos silenciosos, sobre todo bloqueadores de scripts.
Segundo, fuerza una recarga profunda con la combinacion de recarga ignorando cache. ComfyUI guarda mucho estado en el almacenamiento local del navegador y, tras una actualizacion, la interfaz nueva intenta leer un estado antiguo y falla. Vaciar el almacenamiento local del sitio soluciona la interfaz rota que aparece justo despues de actualizar.
Tercero, si sigue en blanco, cambia el puerto de arranque. Programas de captura de pantalla, servicios de desarrollo y algunas suites corporativas ocupan puertos comunes. Lanzar ComfyUI en otro puerto te dice en un minuto si el conflicto era ese.
Nodos rojos despues de actualizar
Un nodo rojo significa que el workflow pide un nodo que la instalacion actual no tiene. No significa que el workflow este mal. Ocurre en tres situaciones: descargaste un workflow ajeno que usa extensiones que no tienes, actualizaste ComfyUI y una extension quedo incompatible, o actualizaste una extension y esta renombro sus nodos.
La forma correcta de resolverlo es abrir el gestor de nodos e instalar los nodos que faltan a partir del propio workflow, en lugar de buscar paquetes a ciegas. El gestor lee el workflow y te dice exactamente que extension proporciona cada nodo faltante. Despues del reinicio, si algun nodo sigue rojo, ese paquete concreto esta roto o abandonado.
Cuando la actualizacion es la que rompe todo
Actualizar ComfyUI y todas las extensiones a la vez es la peor practica posible. Si el resultado es un desastre, no sabes cual de los quince paquetes lo causo. Actualiza el nucleo primero, arranca, verifica que un workflow simple funciona, y solo entonces actualiza extensiones en tandas pequeñas. Si algo se rompe, sabes exactamente quien fue.
Cuando ya estas en el desastre, la salida mas eficiente es desactivar todas las extensiones de golpe (renombrando la carpeta de custom nodes) y reactivarlas de a poco. Con el arranque limpio confirmado, cada reactivacion tarda un minuto y el culpable aparece solo. Es tedioso pero es determinista, que es mas de lo que se puede decir de reinstalar y rezar.
Los modelos no aparecen en el selector
El selector vacio casi siempre es un problema de ubicacion o de formato, no de ComfyUI. Los checkpoints tienen que estar en la carpeta de checkpoints, los LoRA en la de LoRA y los VAE en la suya. Un archivo colocado en la carpeta equivocada simplemente no se lista, sin ningun aviso.
Comprueba tambien que la descarga termino. Un archivo de modelo interrumpido pesa menos de lo que deberia y ComfyUI lo ignora o falla al cargarlo. Si bajaste el modelo desde un repositorio publico, compara el tamaño con el que muestra la pagina de origen. Nuestra guia de Civitai en español explica como verificar descargas y como leer las notas del autor, que suelen indicar si el modelo necesita un VAE aparte.
Otro detalle: ComfyUI escanea las carpetas de modelos al arrancar. Si copiaste el archivo con el programa ya abierto, no aparecera hasta que uses el boton de refrescar o reinicies. Y si usas rutas externas configuradas para compartir modelos con otra interfaz, un error de sintaxis en ese archivo de configuracion hace que se ignore entero y todas las carpetas queden vacias a la vez. Ese sintoma (todo vacio, no un modelo suelto) apunta directo a la configuracion de rutas.
Modelos que cargan pero fallan al generar
Un checkpoint puede cargar y aun asi romper la generacion si el workflow espera otra arquitectura. Mezclar un LoRA entrenado para una base con un checkpoint de otra familia produce errores de dimensiones o imagenes destruidas. Si trabajas con bases especializadas, revisa la guia de Pony Diffusion XL y la de Illustrious XL para confirmar que combinas piezas compatibles. Lo mismo aplica a los flujos basados en Flux, que usan una estructura de nodos propia y no aceptan componentes pensados para otras bases.
Errores de memoria y VRAM insuficiente
Los fallos de memoria aparecen cuando el modelo, el trabajo intermedio y todo lo que ya ocupa la tarjeta no caben juntos. Antes de asumir que tu tarjeta es insuficiente, libera lo que puedes liberar: cierra el navegador con muchas pestañas, cierra clientes de juegos y aplicaciones de video, y comprueba cuanta memoria de video esta ocupada en reposo. En equipos con pantallas de alta resolucion, el escritorio ya consume una porcion nada despreciable.
Despues, ataca el workflow. Baja la resolucion de partida y usa un escalado en un segundo paso en lugar de generar directo en un tamaño enorme. Reduce el tamaño de lote a una imagen. Si usas varios modelos en el mismo grafo (un modelo base, un refinador, un upscaler y detectores de rostro), cada uno ocupa memoria mientras esta cargado. Dividir ese grafo en dos ejecuciones consume menos que hacerlo todo de una pasada.
ComfyUI tambien acepta modos de arranque que priorizan memoria baja, moviendo partes del modelo a la memoria del sistema. La generacion se vuelve mas lenta, pero termina. Es la diferencia entre una imagen lenta y ninguna imagen. Si tu equipo esta claramente por debajo de lo que pide el modelo, ese modo es la respuesta honesta, no un parche temporal, y en ese escenario conviene evaluar tambien un generador en linea sin requisitos de hardware para el trabajo que no justifica pelear con la memoria local.
Imagenes negras, grises o llenas de ruido
Una salida completamente negra suele ser un problema de VAE o de precision numerica. Prueba primero cargando un VAE externo explicitamente en lugar de usar el incorporado en el checkpoint. Si el negro desaparece, el VAE embebido estaba dañado o no era el adecuado. Si el problema persiste, prueba a arrancar forzando otro modo de precision, porque ciertas combinaciones de tarjeta y controlador producen desbordamientos silenciosos que terminan en un lienzo vacio.
El ruido sin forma, en cambio, apunta a un numero de pasos demasiado bajo, a un valor de guia extremo o a un muestreador incompatible con el planificador elegido. Vuelve a una configuracion conservadora y conocida, confirma que produce algo coherente, y solo entonces mueve un parametro por vez. Cambiar tres cosas a la vez y mirar el resultado no es depurar, es adivinar.
Si el problema aparece solo cuando usas guias estructurales, la causa suele estar en el preprocesador y no en el modelo. La guia de ControlNet en español detalla que preprocesador corresponde a cada tipo de control, que es donde se rompe la mayoria de los grafos importados.
La cola se queda congelada
Si la barra de progreso no avanza y la consola tampoco imprime nada, revisa si el proceso sigue vivo en el administrador de tareas. Un backend caido deja la interfaz con la ultima imagen conocida y sin ningun aviso. Si el proceso vive pero no consume recursos, probablemente esta esperando por un nodo que pide una entrada que nunca llega, tipico en grafos con ramas condicionales mal conectadas.
Cuando la cola avanza pero cada imagen tarda muchisimo mas de lo normal, sospecha de la memoria compartida. Si el controlador grafico empezo a volcar parte del modelo a la memoria del sistema, la velocidad cae de forma brutal sin dar ningun error. Reiniciar ComfyUI limpia el estado y suele devolver los tiempos normales, al menos hasta la siguiente sesion larga.
Tabla rapida de sintomas
Usa esta tabla para orientar el diagnostico en el primer minuto, antes de tocar configuraciones.
| Sintoma | Causa probable | Primera accion |
|---|---|---|
| La consola se abre y se cierra sola | Entorno de Python roto o custom node que revienta al importar | Lanzar desde una terminal ya abierta y leer el error |
| Servidor activo, navegador en blanco | Cache o almacenamiento local antiguo, extension del navegador | Abrir en incognito y vaciar el almacenamiento local |
| Nodos rojos tras actualizar | Extension incompatible o ausente | Instalar nodos faltantes desde el gestor con el workflow abierto |
| Selector de modelos vacio | Ruta equivocada o configuracion de rutas externas mal formada | Verificar carpeta correcta y refrescar sin reiniciar |
| Error de memoria al generar | Resolucion, lote o cadena de modelos demasiado exigente | Bajar resolucion, lote a uno, dividir el grafo |
| Imagen totalmente negra | VAE dañado o modo de precision incompatible | Cargar un VAE externo explicito |
| Cola congelada sin mensajes | Backend caido o rama del grafo sin entrada | Comprobar si el proceso sigue vivo |
| Generacion mucho mas lenta de lo habitual | Volcado a memoria del sistema | Reiniciar el programa y cerrar aplicaciones pesadas |
Checklist de diagnostico, de lo mas rapido a lo mas lento
- Cierra todas las consolas y ventanas de ComfyUI y arranca una sola instancia.
- Lee la consola completa, no solo la ultima linea. El primer error importa mas que el ultimo.
- Abre la interfaz en incognito para descartar extensiones y cache.
- Prueba un workflow minimo por defecto, sin extensiones ni LoRA, para saber si el nucleo esta sano.
- Confirma que el checkpoint aparece en el selector y que su tamaño es el esperado.
- Baja resolucion y tamaño de lote a lo minimo y vuelve a generar.
- Desactiva todas las extensiones renombrando la carpeta y arranca de nuevo.
- Reactiva extensiones en grupos pequeños hasta reproducir el fallo.
- Actualiza el controlador grafico solo despues de descartar todo lo anterior.
- Recrea el entorno virtual como ultimo recurso, conservando modelos y workflows.
Que hacer mientras el equipo local esta roto
Reparar una instalacion puede llevar una tarde entera, y a veces hay trabajo que no puede esperar. Si necesitas generar imagenes mientras diagnosticas, un generador en linea te saca del paso sin tocar nada de tu instalacion. Herramientas como este generador que corre en el navegador no dependen de tu tarjeta grafica ni de tus dependencias locales, asi que sirven como red de seguridad mientras el entorno local vuelve a la vida.
Tambien es util como prueba de sanidad mental. Si el prompt que te da resultados raros en local funciona bien en un servicio externo, el problema es tu configuracion y no la idea. Esa comprobacion cuesta dos minutos y evita perseguir fantasmas en el workflow.
Como evitar que se rompa otra vez
Tres habitos reducen la mayoria de las averias futuras. El primero es hacer una copia de la carpeta de custom nodes y de los workflows antes de cada actualizacion. Ocupa poco y convierte cualquier desastre en un retroceso de dos minutos. El segundo es no actualizar por costumbre. Si tu instalacion hace lo que necesitas, una actualizacion solo introduce riesgo sin beneficio.
El tercero es documentar tus workflows buenos. Guarda una version conocida y funcional de cada grafo que uses en serio, con el nombre del checkpoint y los parametros que funcionaron. Cuando algo falle, tendras una referencia limpia contra la que comparar. Si ademas entrenas modelos propios, la guia para entrenar LoRA incluye recomendaciones de organizacion de archivos que evitan buena parte de los conflictos de compatibilidad.
Por ultimo, si ComfyUI te resulta demasiado fragil para tu uso diario, no es una derrota cambiar de herramienta. Una interfaz mas simple sobre una instalacion estandar de Stable Diffusion ofrece menos control pero se rompe muchisimo menos, y para la mayoria de los flujos de trabajo eso es un intercambio razonable.
¿ComfyUI dejo de funcionar despues de actualizar Windows, que hago?
Las actualizaciones del sistema a veces reemplazan el controlador grafico por una version generica. Reinstala el controlador desde la pagina del fabricante de tu tarjeta y reinicia. Si el arranque sigue fallando, revisa que el antivirus no haya puesto en cuarentena archivos del entorno de Python durante la actualizacion.
¿Puedo usar ComfyUI sin tarjeta grafica dedicada?
Tecnicamente si, funcionando sobre el procesador, pero los tiempos de generacion se vuelven poco practicos para trabajar. Si tu equipo no tiene tarjeta dedicada, un servicio en linea o una instancia en la nube da una experiencia mucho mas usable que insistir con ejecucion por procesador.
¿Por que un workflow que descargue no funciona en mi instalacion?
Porque los workflows guardan referencias a nodos y a nombres de modelos concretos. Si no tienes esas extensiones instaladas, apareceran nodos rojos, y si el nombre del checkpoint no coincide exactamente, el nodo cargador quedara vacio. Instala los nodos faltantes y reasigna los modelos a mano.
¿Es seguro borrar la carpeta de custom nodes?
Renombrarla es mas seguro que borrarla, porque conservas todo por si el problema estaba en otra parte. Con la carpeta renombrada, ComfyUI arranca sin extensiones y sabras en un minuto si el fallo venia de ahi. Despues puedes restaurar los paquetes que realmente usas.
¿Que significa que la generacion termine pero no aparezca la imagen?
Suele indicar que el nodo de guardado o de vista previa no esta conectado a la salida final del grafo, o que apunta a una carpeta sin permisos de escritura. Revisa la conexion del ultimo nodo y comprueba que la carpeta de salida existe y es escribible.
¿Mi instalacion funciona pero consume toda la memoria del sistema?
Es normal que suba mientras carga modelos, pero si no baja al terminar, es probable que el grafo mantenga varios modelos cargados a la vez. Divide el trabajo en ejecuciones separadas y evita encadenar base, refinador y varios detectores en un solo grafo si tu equipo es justo.
¿Conviene reinstalar desde cero o reparar?
Repara primero, porque la reinstalacion te hace perder configuraciones y tiempo de descarga. Solo reinstala si el entorno de Python esta claramente corrupto o si moviste la carpeta y las rutas internas dejaron de resolverse. En ese caso, conserva modelos y workflows y recrea unicamente el entorno.
¿Como se si el problema es del modelo y no del programa?
Genera una imagen con un checkpoint distinto y el mismo workflow simple. Si con otro modelo funciona, el problema es del archivo. Si falla con todos, el problema esta en el entorno o en la configuracion. Esta prueba de dos minutos ahorra la mayoria de los diagnosticos equivocados.
