> ## Documentation Index
> Fetch the complete documentation index at: https://docs.comfy.org/llms.txt
> Use this file to discover all available pages before exploring further.

# Flags de inicio

> Referencia de flags de inicio de ComfyUI: argumentos de main.py en comfy/cli_args.py y cómo añadirlos a los .bat de Windows Portable.

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`](https://github.com/Comfy-Org/ComfyUI/blob/master/comfy/cli_args.py).

> [!NOTE]
>
> 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](https://docs.comfy.org/es/installation/comfyui_portable_windows.md) 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:

```bash theme={null}
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. |

```bash theme={null}
# 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. |

> [!NOTE]
>
> `--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`.

```bash theme={null}
# 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. |

> [!NOTE]
>
> En Windows, ComfyUI usa solo la GPU 0 de forma predeterminada. Para restaurar todas las GPU, pasa `--cuda-device all`.

## Precisión e inferencia

> [!NOTE]
>
> 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](#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é

> [!NOTE]
>
> 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. |

> [!NOTE]
>
> 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

> [!NOTE]
>
> 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.

> [!NOTE]
>
> 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. |

```bash theme={null}
# 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](https://docs.comfy.org/es/manager/install.md) 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. |

> [!NOTE]
>
> `--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.

```bash theme={null}
# 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. |

```bash theme={null}
# 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. |

***

> [!NOTE]
>
> Esta referencia se basa en ComfyUI [`comfy/cli_args.py`](https://github.com/Comfy-Org/ComfyUI/blob/master/comfy/cli_args.py). Al actualizar ComfyUI, ejecuta `python main.py --help` o compara tu [`cli_args.py`](https://github.com/Comfy-Org/ComfyUI/blob/master/comfy/cli_args.py) local con esta página para comprobar si hay flags nuevos o modificados.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.