Memoria de vídeo insuficiente y bloqueos: solución sistemática de OOM
A mitad de la generación aparece CUDA out of memory, o la barra de progreso se congela y la VRAM se llena por completo: esto es memoria de vídeo insuficiente, uno de los problemas más comunes en ComfyUI. No te apresures a cambiar de tarjeta gráfica: siguiendo el orden de diagnóstico que se indica a continuación, la mayoría de los OOM se pueden resolver a nivel de software. Si es tu primera vez depurando errores, se recomienda repasar primero la introducción a la resolución de problemas.
Síntomas: identifica primero tu caso
CUDA out of memory / torch.OutOfMemoryError
Primero reinicia ComfyUI para liberar la memoria de vídeo que pueda haberse filtrado, y luego inicia con --lowvram, para que el codificador de texto se ejecute en la CPU y se reduzca el uso de VRAM.
La barra de progreso se congela, la VRAM se llena pero no aparece ningún error
Usa primero nvidia-smi para ver quién está ocupando la VRAM; cierra el navegador, los juegos y otros programas de dibujo, y vuelve a intentarlo.
Se cuelga siempre después de cambiar a un modelo más grande
Los pesos del modelo grande superan directamente la memoria de vídeo física; ajustar parámetros solo lo mitiga, y la solución definitiva es cambiar a una versión cuantizada o a un checkpoint más pequeño.
Comprobación rápida (60 segundos)
- Usa
nvidia-smio el Administrador de tareas para confirmar que ningún navegador, juego u otro programa de IA esté compitiendo por la VRAM. - Reinicia ComfyUI. Tras una interrupción anómala, la VRAM a menudo no se libera; reiniciar es la forma más rápida de "poner a cero".
- Reduce la resolución y el tamaño de lote (batch size) al mínimo, para demostrar primero que el flujo de trabajo funciona.
- Cuenta cuántos modelos se cargan a la vez en esta generación: el checkpoint, ControlNet, los modelos de ampliación y los LoRA cuentan todos.
¿Sigue habiendo OOM después de esto? Pasa al diagnóstico formal.
Pasos de diagnóstico
Paso 1: reducir la presión de VRAM de cada generación
La mayoría de los OOM se deben a "pedir demasiado de una sola vez". Baja primero la resolución un nivel (por ejemplo 512×768), pon el batch size en 1, y una vez que funcione ve subiéndolo gradualmente para encontrar el punto límite de tu máquina. Comprueba también si el flujo de trabajo tiene varios nodos de modelos grandes conectados a la vez, y desconecta los que no uses: cada modelo residente en la VRAM eleva el pico de uso.
Paso 2: redistribuir la VRAM con parámetros de inicio
ComfyUI ofrece un conjunto de parámetros de inicio para controlar la estrategia de memoria; combínalos según lo que necesites:
--lowvram: modo de baja VRAM; hace que el codificador de texto se ejecute en la CPU, intercambiando velocidad por memoria; es el más usado.--cpu: traslada el cálculo a la memoria RAM y la CPU; es extremadamente lento pero casi nunca provoca OOM, útil para verificar un flujo de trabajo con urgencia.--reserve-vram: reserva una parte de la VRAM para el sistema u otros programas, evitando que la tarjeta gráfica se agote y todo el equipo se congele.--async-offload: intercambia los pesos de los modelos de forma asíncrona durante la generación, reduciendo aún más el pico de uso (en tarjetas NVIDIA ya está activado por defecto).--cache-*: serie que controla la estrategia de caché y reciclaje de los modelos y los resultados de los nodos; los valores habituales son--cache-none(menos uso de RAM/VRAM, pero cada nodo se vuelve a ejecutar en cada pasada),--cache-lru 10(cachear como máximo 10 resultados de nodos) y--cache-classic(caché agresiva de la versión antigua).
Los usuarios del paquete portátil de Windows normalmente añaden estos parámetros en el script de inicio: edita el archivo run_nvidia_gpu.bat en la raíz del paquete portátil y añádelos al final de la línea .\python_embeded\python.exe -s ComfyUI\main.py --windows-standalone-build.
Paso 3: cambiar a un modelo más pequeño o a una versión cuantizada
Si con los parámetros al máximo aún hay OOM frecuentes, significa que el modelo en sí es demasiado grande para tu VRAM. Hay dos caminos: uno, usar modelos cuantizados GGUF, que permiten ejecutar modelos grandes incluso con poca VRAM (ver Modelos cuantizados GGUF: ejecutar modelos grandes con poca VRAM); dos, cambiar directamente a un checkpoint más pequeño, para dominar primero el flujo con un modelo pequeño.
Nota importante: si el error aparece justo al cargar el modelo (y no como OOM a mitad de la generación), lo más probable es que no sea un problema de VRAM; consulta la página anterior Fallo al cargar el modelo.
Condiciones para actualizar el hardware: cuándo dejar de ajustar parámetros
Si se cumple cualquiera de estas condiciones, no sigas gastando tiempo a nivel de software:
--lowvram+ resolución mínima + modelo cuantizado y aun así el OOM siempre aparece: la VRAM está físicamente por debajo del mínimo del modelo; considera actualizar la tarjeta gráfica, o aceptar generar imágenes a largo plazo en el modo lento de--cpu.- La VRAM no se llena pero los bloqueos persisten: el problema puede no estar en la memoria; vuelve a la introducción a la resolución de problemas para localizarlo según los registros.
- El error no es OOM, sino de carga o de arquitectura: pasa a Fallo al cargar el modelo.
- Ninguno coincide: con el registro completo de la consola en mano, busca "out of memory" en el repositorio de GitHub de ComfyUI; lo más probable es que alguien ya haya pisado el mismo charco.