Flags de inicio

ComfyUI acepta argumentos de línea de comandos cuando se inicia con python main.py. Esta página documenta todos los flags definidos en comfy/cli_args.py.

Los usuarios de Windows Portable pueden añadir flags a los archivos .bat de inicio (por ejemplo, run_nvidia_gpu.bat). Consulta la guía de Windows Portable para ver los detalles.

Ejecuta python main.py --help en tu directorio de ComfyUI para ver el texto de ayuda integrado. Combina varios flags según necesites:

python main.py --listen 0.0.0.0 --port 8288 --disable-auto-launch --lowvram

Red y servidor

Flag	Predeterminado	Descripción
`--listen` `[IP]`	`127.0.0.1`	Dirección IP en la que escuchar. Se admite una lista separada por comas (p. ej. `127.2.2.2,127.3.3.3`). Si se indica sin valor, toma `0.0.0.0,::` por defecto (todas las interfaces IPv4 e IPv6).
`--port`	`8188`	Puerto en el que escuchar.
`--tls-keyfile` `PATH`	Ninguno	Ruta al archivo de clave TLS (SSL). Habilita HTTPS. Requiere `--tls-certfile`.
`--tls-certfile` `PATH`	Ninguno	Ruta al archivo de certificado TLS (SSL). Habilita HTTPS. Requiere `--tls-keyfile`.
`--enable-cors-header` `[ORIGIN]`	deshabilitado	Habilita CORS. Origen opcional, o `*` para todos los orígenes cuando no se indica un valor.
`--max-upload-size`	`100`	Tamaño máximo de subida en MB.
`--enable-compress-response-body`	deshabilitado	Habilita la compresión del cuerpo de la respuesta HTTP.

# Escuchar en todas las interfaces (acceso a la LAN)
python main.py --listen

# Escuchar en una IP específica
python main.py --listen 0.0.0.0

# Puerto personalizado con HTTPS
python main.py --port 8443 --tls-keyfile key.pem --tls-certfile cert.pem

Directorios

Opción	Predeterminado	Descripción
`--base-directory` `PATH`	Raíz de ComfyUI	Directorio base para los directorios de modelos, custom_nodes, entrada, salida, temp y usuario.
`--models-directory` `PATH`	Raíz de ComfyUI/models	Directorio de modelos. Anula la carpeta de modelos en `--base-directory`.
`--extra-model-paths-config` `PATH`	—	Carga uno o más archivos `extra_model_paths.yaml`. Se puede especificar varias veces.
`--output-directory` `PATH`	—	Directorio de salida. Anula `--base-directory`.
`--temp-directory` `PATH`	—	Directorio temporal. Anula `--base-directory`.
`--input-directory` `PATH`	—	Directorio de entrada. Anula `--base-directory`.
`--user-directory` `PATH`	—	Directorio de usuario (ruta absoluta). Anula `--base-directory`. La ruta debe existir y ser legible.

Inicio y navegador

Flag	Predeterminado	Descripción
`--auto-launch`	deshabilitado	Abre ComfyUI automáticamente en el navegador predeterminado al iniciar.
`--disable-auto-launch`	deshabilitado	Deshabilita la apertura automática del navegador.
`--windows-standalone-build`	deshabilitado	Modo de comodidad de la compilación portable de Windows. Habilita la apertura automática al iniciar (equivale a `--auto-launch`) y activa el sistema de recursos.

--windows-standalone-build establece auto_launch en true y habilita el sistema de recursos. --disable-auto-launch anula la apertura del navegador y --disable-assets anula el sistema de recursos. Para ejecutar como servidor sin abrir un navegador, usa --disable-auto-launch.

# Run server without opening browser
python main.py --disable-auto-launch

Dispositivos y CUDA

Flag	Predeterminado	Descripción
`--cuda-device` `DEVICE_ID`	Ninguno	IDs de dispositivo CUDA que se usarán, separados por comas (p. ej. `0` o `0,1`), o `all` para conservar todos los dispositivos visibles en ese momento. Los demás dispositivos quedan ocultos.
`--default-device` `ID`	Ninguno	ID del dispositivo predeterminado. Todos los demás dispositivos permanecen visibles.
`--cuda-malloc`	automático (torch 2.0+)	Habilita cudaMallocAsync. Es mutuamente excluyente con `--disable-cuda-malloc`.
`--disable-cuda-malloc`	Ninguno	Deshabilita cudaMallocAsync. Es mutuamente excluyente con `--cuda-malloc`.
`--directml` `[DEVICE]`	Ninguno	Usa torch-directml. Índice de dispositivo opcional; si no se indica un valor, se usa `-1` de forma predeterminada.
`--oneapi-device-selector` `STRING`	Ninguno	Cadena selectora de dispositivo oneAPI para dispositivos Intel.

En Windows, ComfyUI usa solo la GPU 0 de forma predeterminada. Para restaurar todas las GPU, pasa --cuda-device all.

Precisión e inferencia

Los flags de los grupos Global, UNET, VAE y Text Encoder que aparecen a continuación son mutuamente excluyentes dentro de cada grupo. Solo puedes usar un flag por grupo a la vez.

Punto flotante global

Flag	Descripción
`--force-fp32`	Fuerza fp32 de forma global. Reporta si esto mejora el rendimiento de la GPU.
`--force-fp16`	Fuerza fp16 de forma global. También establece `--fp16-unet`.

Precisión de UNET

Flag	Descripción
`--fp32-unet`	Ejecuta el modelo de difusión en fp32.
`--fp64-unet`	Ejecuta el modelo de difusión en fp64.
`--bf16-unet`	Ejecuta el modelo de difusión en bf16.
`--fp16-unet`	Ejecuta el modelo de difusión en fp16.
`--fp8_e4m3fn-unet`	Almacena los pesos de UNET en fp8 (e4m3fn).
`--fp8_e5m2-unet`	Almacena los pesos de UNET en fp8 (e5m2).
`--fp8_e8m0fnu-unet`	Almacena los pesos de UNET en fp8 (e8m0fnu).

Cada sufijo de flag de FP8 indica un formato de coma flotante de 8 bits de la especificación FP8 de la industria (ONNX / OCP):

e4m3fn: 4 bits de exponente, 3 bits de mantisa. Buen equilibrio entre precisión y alcance para los pesos del modelo en GPU NVIDIA Ada Lovelace y posteriores.
e5m2: 5 bits de exponente, 2 bits de mantisa. Mayor rango dinámico pero menor precisión que e4m3fn. Útil cuando las magnitudes de los pesos varían mucho.
e8m0fnu: 8 bits de exponente, 0 bits de mantisa. Máximo rango dinámico sin precisión fraccionaria. Normalmente se usa como factor de escala por bloques (solo potencias de dos).

Precisión de VAE

Flag	Descripción
`--fp16-vae`	Ejecuta el VAE en fp16. Puede causar imágenes negras.
`--fp32-vae`	Ejecuta el VAE en precisión completa fp32.
`--bf16-vae`	Ejecuta el VAE en bf16.
`--cpu-vae`	Ejecuta el VAE en la CPU (no es mutuamente excluyente con los flags de precisión de VAE).

Precisión del codificador de texto

Flag	Descripción
`--fp8_e4m3fn-text-enc`	Almacena los pesos del codificador de texto en fp8 (e4m3fn).
`--fp8_e5m2-text-enc`	Almacena los pesos del codificador de texto en fp8 (e5m2).
`--fp16-text-enc`	Almacena los pesos del codificador de texto en fp16.
`--fp32-text-enc`	Almacena los pesos del codificador de texto en fp32.
`--bf16-text-enc`	Almacena los pesos del codificador de texto en bf16.

Consulta la sección Precisión de UNET para ver la explicación de cada sufijo de formato FP8.

Otras opciones de inferencia

Flag	Predeterminado	Descripción
`--fp16-intermediates`	deshabilitado	Experimental: usa fp16 para los tensores intermedios entre nodos en lugar de fp32.
`--force-channels-last`	deshabilitado	Fuerza el formato de memoria de canales al final durante la inferencia.
`--supports-fp8-compute`	deshabilitado	Actúa como si el dispositivo admitiera cómputo fp8.
`--enable-triton-backend`	deshabilitado	Habilita el backend Triton en comfy-kitchen. Deshabilitado de forma predeterminada al iniciar.
`--disable-triton-backend`	deshabilitado	Fuerza la deshabilitación del backend Triton de comfy-kitchen, anulando `--enable-triton-backend`.

Vista previa

Flag	Predeterminado	Descripción
`--preview-method`	`none`	Método de vista previa para nodos sampler. Opciones: `none`, `auto`, `latent2rgb`, `taesd`.
`--preview-size`	`512`	Tamaño máximo de la vista previa de imagen en píxeles.

Caché

Los flags de modo de caché son mutuamente excluyentes. Solo debes usar uno de --cache-ram, --cache-classic, --high-ram, --cache-lru o --cache-none.

Flag	Predeterminado	Descripción
`--cache-ram` `[GB] [GB]`	habilitado (modo predeterminado)	Caché por presión de RAM. Primer valor: umbral de caché activa en GB. Segundo valor opcional: umbral de caché inactiva/anclaje en GB. Si no se dan valores: activa = 10 % de la RAM del sistema (mín. 2 GB, máx. 10 GB); inactiva = 100 % de la RAM del sistema (máx. 128 GB). Acepta como máximo dos valores.
`--cache-classic`	—	Usa el antiguo estilo de caché agresiva.
`--high-ram`	deshabilitado	Puede mejorar ligeramente el rendimiento en sistemas con abundante RAM o donde se prefiere usar el archivo de paginación antes que recargar modelos. También habilita la caché clásica.
`--cache-lru` `N`	`0` (deshabilitado)	Caché LRU con un máximo de N resultados de nodo en caché. Sin límite superior estricto; está acotada por la RAM/VRAM disponible. Puede usar más RAM/VRAM.
`--cache-none`	—	Menor uso de RAM/VRAM; vuelve a ejecutar cada nodo en cada ejecución.

ComfyUI reutiliza los resultados de nodo en caché entre ejecuciones de la misma sesión, y eso es lo que hace más rápidas las ejecuciones repetidas. Usa --cache-none cuando prefieras que cada ejecución comience con una caché limpia, por ejemplo mientras depuras un flujo de trabajo o descartas la reutilización de la caché entre ejecuciones. Cada nodo se vuelve a ejecutar, así que las generaciones tardan más. Es un flag de inicio, por lo que debes reiniciar ComfyUI para que tenga efecto.

Atención

Las flags de método de atención cruzada son mutuamente excluyentes. La atención dividida y la atención quad se ignoran cuando se usa xformers.

Flag	Descripción
`--use-split-cross-attention`	Usar la optimización de atención cruzada dividida.
`--use-quad-cross-attention`	Usar la optimización de atención cruzada subcuadrática.
`--use-pytorch-cross-attention`	Usar la atención cruzada de PyTorch 2.0.
`--use-sage-attention`	Usar la atención Sage.
`--use-flash-attention`	Usar FlashAttention.
`--use-ck-attention`	Usar la atención de Comfy Kitchen. Requiere soporte de hardware para sus kernels INT8.
`--disable-xformers`	Desactivar xformers.
`--force-upcast-attention`	Forzar el upcasting de atención. Reporta si esto soluciona las imágenes negras. Es mutuamente excluyente con `--dont-upcast-attention`.
`--dont-upcast-attention`	Desactivar todo el upcasting de atención. Solo para depuración.

VRAM y memoria

La descarga asíncrona de pesos está activada por defecto en GPU Nvidia y AMD, y la VRAM dinámica se habilita automáticamente donde es compatible. Los flags siguientes anulan esos valores predeterminados.

Los flags de modo de VRAM (--gpu-only, --highvram, --lowvram, --novram, --cpu) son mutuamente excluyentes.

Flag	Predeterminado	Descripción
`--gpu-only`	—	Almacena y ejecuta todo en la GPU (codificadores de texto, CLIP, etc.).
`--highvram`	—	Mantiene los modelos en la memoria de la GPU en lugar de descargarlos a la CPU después de usarlos.
`--lowvram`	—	No tiene efecto cuando la VRAM dinámica está habilitada. De lo contrario, ejecuta los codificadores de texto en la CPU.
`--novram`	—	Uso mínimo de VRAM cuando `--lowvram` no es suficiente.
`--cpu`	—	Usa la CPU para todo (lento).
`--reserve-vram` `GB`	Depende del sistema operativo	VRAM en GB que se reserva para el sistema operativo y otro software.
`--vram-headroom` `GB`	`0`	VRAM adicional en GB que la VRAM dinámica mantiene libre por encima del margen predeterminado. ComfyUI intenta mantener esa cantidad de VRAM completamente libre y sin usar, incluso contando la VRAM que usan otras aplicaciones.
`--disable-nvml-pressure`	deshabilitado	Usa CUDA en lugar de NVML para reportar la presión de memoria de la VRAM dinámica.
`--async-offload` `[NUM_STREAMS]`	habilitado en Nvidia y AMD	Descarga asíncrona de pesos. Cantidad de streams opcional (predeterminado: 2).
`--disable-async-offload`	—	Deshabilita la descarga asíncrona de pesos.
`--disable-dynamic-vram`	—	Deshabilita la VRAM dinámica; usa la carga de modelos basada en estimaciones.
`--enable-dynamic-vram`	automático en Nvidia, ROCm 7.14+	Habilita la VRAM dinámica en sistemas donde no está habilitada por defecto.
`--fast-disk`	falso	Fuerza la carga y descarga dinámicas respaldadas por disco en lugar de la RAM no fijada. Útil con NVMe rápido. Cuando no se establece ni este flag ni `--disable-fast-disk`, la carga y descarga respaldadas por disco se habilitan automáticamente si todos los archivos de modelos están en almacenamiento detectado como rápido.
`--disable-fast-disk`	deshabilitado	Deshabilita la carga y descarga dinámicas respaldadas por disco, de modo que se usa la RAM no fijada en su lugar. Anula `--fast-disk` y la detección automática.
`--disable-cuda-graphs`	deshabilitado	Deshabilita los CUDA graphs.
`--disable-comfy-compiler`	deshabilitado	Deshabilita el compilador de modelos de Comfy, incluida su subfunción de CUDA graphs.
`--assert-graph-breaks`	deshabilitado	Falla cuando el compilador de modelos de Comfy produce interrupciones del gráfico.
`--force-non-blocking`	deshabilitado	Fuerza operaciones de tensor no bloqueantes. Puede ayudar en sistemas que no son Nvidia; puede romper algunos flujos de trabajo.
`--disable-smart-memory`	deshabilitado	Descarga de forma agresiva a la RAM en lugar de mantener los modelos en la VRAM.
`--disable-pinned-memory`	deshabilitado	Deshabilita el uso de memoria fijada.
`--mmap-torch-files`	deshabilitado	Usa mmap al cargar archivos ckpt/pt.
`--disable-mmap`	deshabilitado	No usa mmap al cargar safetensors.

Rendimiento y depuración

Flag	Predeterminado	Descripción
`--fast` `[OPT...]`	deshabilitado	Habilita optimizaciones experimentales que pueden afectar a la calidad o a la estabilidad. `--fast` por sí solo las habilita todas. Opciones específicas: `fp16_accumulation`, `fp8_matrix_mult`, `cublas_ops`, `autotune`.
`--deterministic`	deshabilitado	Usa algoritmos deterministas de PyTorch, más lentos, cuando es posible. No garantiza imágenes idénticas en todos los casos.
`--default-hashing-function`	`sha256`	Función hash para comparar nombres y contenidos de archivos duplicados. Opciones: `md5`, `sha1`, `sha256`, `sha512`.
`--debug-hang`	deshabilitado	Habilita el volcado de trazas de pila con Ctrl-C para depurar bloqueos.

# Enable all fast optimizations (experimental)
python main.py --fast

# Enable specific optimizations only
python main.py --fast fp16_accumulation cublas_ops

ComfyUI Manager

Consulta ComfyUI-Manager Installation para ver las instrucciones de configuración.

Opción	Descripción
`--enable-manager`	Habilita ComfyUI-Manager.
`--disable-manager-ui`	Deshabilita solo la UI y los endpoints ComfyUI Manager. Las tareas en segundo plano (instalaciones programadas, etc.) continúan. Requiere `--enable-manager`.
`--enable-manager-legacy-ui`	Usa la UI clásica ComfyUI Manager. Implica `--enable-manager`. Es mutuamente excluyente con `--disable-manager-ui`.

Nodos personalizados y nodos de API

Flag	Predeterminado	Descripción
`--disable-all-custom-nodes`	deshabilitado	Deshabilita la carga de todos los nodos personalizados.
`--whitelist-custom-nodes` `FOLDER...`	—	Carpetas de nodos personalizados que se cargan incluso cuando `--disable-all-custom-nodes` está establecido.
`--disabled-nodes-config` `PATH`	—	Ruta a un archivo YAML que enumera los IDs de nodo a deshabilitar. El archivo debe contener una lista `disabled_nodes` con cadenas de IDs de nodo.
`--disable-partner-nodes`	deshabilitado	Deshabilita la carga de Nodos asociados (los nodos de API de pago). El frontend conserva su acceso a internet.
`--offline`	deshabilitado	Impide que el frontend se comunique con internet añadiendo una Content-Security-Policy restrictiva. También deshabilita los Nodos asociados.
`--disable-api-nodes`	deshabilitado	Alias obsoleto de `--offline`. Usa `--offline`, o `--disable-partner-nodes` para deshabilitar solo los Nodos asociados.
`--disable-metadata`	deshabilitado	Deshabilita el guardado de los metadatos del prompt en los archivos de salida.

--offline también cambia lo que el navegador puede cargar. El flag añade una Content-Security-Policy que mantiene la página en recursos servidos por el propio ComfyUI, así que las imágenes, fuentes, medios, fotogramas y solicitudes de red de otros orígenes quedan bloqueados, y los Nodos asociados (nodos de API) no se registran en absoluto. Si una vista previa o una miniatura que normalmente se carga desaparece después de un reinicio, revisa los argumentos de inicio en busca de este flag antes de depurar el nodo. --disable-partner-nodes solo impide que se carguen los Nodos asociados y deja intacto el resto del acceso a internet del frontend.

# Troubleshoot custom node issues
python main.py --disable-all-custom-nodes

# Allow only specific custom nodes
python main.py --disable-all-custom-nodes --whitelist-custom-nodes ComfyUI-Manager

Frontend y API

Flag	Predeterminado	Descripción
`--front-end-version`	`comfyanonymous/ComfyUI@latest`	Versión del frontend con el formato `[owner]/[repo]@[version]`. Requiere internet para descargarla desde las releases de GitHub. La versión puede ser `latest` o una versión semver (p. ej. `1.0.0`).
`--front-end-root` `PATH`	—	Ruta del sistema de archivos local al directorio del frontend. Anula `--front-end-version`.
`--comfy-api-base`	`https://api.comfy.org`	URL base de la API de ComfyUI.
`--database-url`	`sqlite:///<ComfyUI>/user/comfyui.db`	URL de la base de datos. Usa `sqlite:///:memory:` para usar la memoria.
`--enable-assets`	deshabilitado	Habilita el sistema de recursos (rutas de API, sincronización con la base de datos, escaneo en segundo plano).
`--disable-assets`	deshabilitado	Deshabilita el sistema de recursos, incluso cuando `--enable-assets` o `--windows-standalone-build` están activados.
`--enable-asset-hashing`	deshabilitado	Calcula hashes de contenido blake3 al escanear recursos. Habilita futuras funciones de portabilidad de recursos, como la deduplicación y la resolución de modelos entre máquinas, a costa del tiempo de inicio y del hashing en cada salida con directorios de modelos grandes. Desactivado de forma predeterminada; requiere el sistema de recursos (`--enable-assets` o `--windows-standalone-build`).
`--feature-flag` `KEY[=VALUE]`	—	Establece un feature flag del servidor. `KEY` por sí solo establece verdadero. Se puede repetir. Los booleanos y los números se convierten automáticamente.
`--list-feature-flags`	—	Imprime como JSON los feature flags conocidos que se pueden establecer desde la CLI y sale.

# List available feature flags
python main.py --list-feature-flags

# Set feature flags
python main.py --feature-flag show_signin_button=true

Registro y varios

Flag	Predeterminado	Descripción
`--verbose` `[LEVEL] [FILE]`	`INFO`	Nivel de registro. Opciones: `DEBUG`, `DETAIL`, `INFO`, `WARNING`, `ERROR`, `CRITICAL`. `--verbose` por sí solo establece `DEBUG`. Agrega un nivel seguido de una ruta de archivo para escribir ese nivel también en un archivo; el flag se puede repetir para configurar juntas las salidas de consola y de archivo.
`--log-stdout`	deshabilitado	Envía la salida normal del proceso a stdout en lugar de stderr.
`--dont-print-server`	deshabilitado	No imprime la salida del servidor en la consola.
`--disable-product-tips`	deshabilitado	Oculta los consejos de la consola acerca de los productos comerciales y los despliegues de Comfy-Org. Equivale a establecer `COMFYUI_DISABLE_PRODUCT_TIPS=1`. Los consejos también se omiten con `CI`, `--dont-print-server` o `--windows-standalone-build`.
`--multi-user`	deshabilitado	Habilita el almacenamiento por usuario.
`--quick-test-for-ci`	deshabilitado	Prueba de inicio rápida para CI. Sale inmediatamente después de la inicialización.

Esta referencia se basa en ComfyUI comfy/cli_args.py. Al actualizar ComfyUI, ejecuta python main.py --help o compara tu cli_args.py local con esta página para comprobar si hay flags nuevos o modificados.

Desarrollar con Comfy

Desplegar ComfyUI

Comfy CLI

Specifications

Nodos personalizados

Flags de inicio

Red y servidor

Directorios

Inicio y navegador

Dispositivos y CUDA

Precisión e inferencia

Punto flotante global

Precisión de UNET

Precisión de VAE

Precisión del codificador de texto

Otras opciones de inferencia

Vista previa

Caché

Atención

VRAM y memoria

Rendimiento y depuración

ComfyUI Manager

Nodos personalizados y nodos de API

Frontend y API

Registro y varios

​Red y servidor

​Directorios

​Inicio y navegador

​Dispositivos y CUDA

​Precisión e inferencia

​Punto flotante global

​Precisión de UNET

​Precisión de VAE

​Precisión del codificador de texto

​Otras opciones de inferencia

​Vista previa

​Caché

​Atención

​VRAM y memoria

​Rendimiento y depuración

​ComfyUI Manager

​Nodos personalizados y nodos de API

​Frontend y API

​Registro y varios

Red y servidor

Directorios

Inicio y navegador

Dispositivos y CUDA

Precisión e inferencia

Punto flotante global

Precisión de UNET

Precisión de VAE

Precisión del codificador de texto

Otras opciones de inferencia

Vista previa

Caché

Atención

VRAM y memoria

Rendimiento y depuración

ComfyUI Manager

Nodos personalizados y nodos de API

Frontend y API

Registro y varios