Guía Completa de Usuario de Comfy CLI

Comfy CLI es la herramienta oficial de línea de comandos para ComfyUI: instala, gestiona nodos y modelos, ejecuta flujos de trabajo y llama a modelos de imagen/video de socios, todo desde tu terminal.

ℹ️ Nota sobre actualizaciones: Para la referencia más actualizada de CLI, consulta el README oficial o docs.comfy.org.

Requisitos

Python 3.10+

Instalación

Recomendado: Usando pip

pip install comfy-cli

Usando pipx (entorno aislado)

pipx install comfy-cli

Usando uv (instalador rápido de paquetes Python)

uv tool install comfy-cli

Autocompletado en el shell

comfy --install-completion

Ahora comfy <TAB> expande comandos y opciones.

Inicio Rápido

# Ejecutar el asistente de configuración interactivo
comfy setup

comfy setup te guía a través de todo (enrutamiento local o en la nube, autenticación e instalación de habilidades del agente) en un único asistente interactivo. Usa -y para instalaciones no interactivas (CI/script).

Alternativamente, instala de forma explícita:

comfy install

Luego inicia:

comfy launch

## Gestión de Espacios de Trabajo

Comfy CLI admite la gestión de múltiples espacios de trabajo de ComfyUI, permitiéndole mantener diferentes entornos de ComfyUI simultáneamente.

### Operaciones Básicas del Espacio de Trabajo

```bash
# Verificar la ruta del espacio de trabajo actual
comfy which

# Establecer espacio de trabajo predeterminado
comfy set-default /ruta/a/tu/espacio-de-trabajo

# Establecer espacio de trabajo predeterminado con parámetros de inicio
comfy set-default /ruta/a/tu/espacio-de-trabajo --launch-extras="--listen 0.0.0.0 --port 8080"

Ejecutar Comandos en Diferentes Espacios de Trabajo

Opción	Caso de uso
`--workspace=<ruta>`	Ejecutar desde ComfyUI instalado en el espacio de trabajo especificado
`--recent`	Ejecutar desde el ComfyUI usado más recientemente
`--here`	Ejecutar desde ComfyUI en el directorio actual

# Iniciar ComfyUI en un espacio de trabajo específico
comfy --workspace=~/projects/project-a launch

# Instalar nodos en el espacio de trabajo reciente
comfy --recent node install ComfyUI-Impact-Pack

# Verificar si el directorio actual tiene ComfyUI
comfy --here which

Nota: --workspace, --recent y --here no se pueden usar juntos.

Reglas de Prioridad del Espacio de Trabajo

Cuando no se especifica un espacio de trabajo:

Ruta predeterminada establecida por comfy set-default <ruta>
ComfyUI ejecutado o instalado más recientemente
ComfyUI en el directorio actual

Opciones de Inicio

Inicio Básico

# Inicio por defecto
comfy launch

# Ejecutar en segundo plano
comfy launch --background

# Detener instancia en segundo plano
comfy stop

# Iniciar con argumentos adicionales
comfy launch -- --cpu --listen 0.0.0.0

Configuración de Red

comfy launch -- --listen 0.0.0.0 --port 8080

Opciones de Rendimiento

comfy launch -- --cpu       # Modo solo CPU
comfy launch -- --lowvram   # Modo de VRAM baja
comfy launch -- --novram     # Modo de VRAM ultrabaja

Prueba de Pull Requests

# Instalar un PR específico de ComfyUI
comfy install --pr "#1234"
comfy install --pr "https://github.com/comfyanonymous/ComfyUI/pull/1234"

# Probar un PR del frontend
comfy launch --frontend-pr "#456"
comfy launch --frontend-pr "usuario:nombre-rama"

Las compilaciones de PR del frontend se almacenan en caché para cambiar rápidamente. Gestione la caché:

comfy pr-cache list              # Listar compilaciones de PR en caché
comfy pr-cache clean             # Limpiar todas las compilaciones en caché
comfy pr-cache clean 456         # Limpiar caché de un PR específico

## Gestión de Nodos Personalizados

### Ver Información del Nodo

```bash
comfy node show all                               # Todos los nodos disponibles
comfy node simple-show installed                  # Lista simple de nodos instalados
comfy node show enabled                           # Solo nodos habilitados
comfy node show not-installed                     # Nodos no instalados
comfy node show disabled                          # Nodos deshabilitados
comfy node show all --channel recent              # Nodos del canal reciente
comfy node show snapshot                          # Ver información actual del snapshot
comfy node show snapshot-list                     # Listar snapshots guardados

Instalar y Actualizar Nodos

comfy node install ComfyUI-Impact-Pack            # Instalar un nodo personalizado
comfy node update all                             # Actualizar todos los nodos
comfy node update ComfyUI-Impact-Pack             # Actualizar un nodo específico

Resolución Rápida de Dependencias

Comfy CLI ofrece dos formas de usar uv para una resolución de dependencias más rápida:

Característica	`--fast-deps`	`--uv-compile`
Alcance	`comfy install`, instalación/reinstalación de nodos	Solo comandos de nodos personalizados
Resolvedor	Integrado en comfy-cli	Resolvedor unificado de ComfyUI-Manager v4.1+
Manejo de conflictos	Indicador interactivo	Automático con atribución de nodo

# Instalación inicial rápida
comfy install --fast-deps

# uv-compile para gestión de nodos personalizados (requiere ComfyUI-Manager v4.1+)
comfy node install comfyui-impact-pack --uv-compile

# Ejecutar independiente (resolver todas las dependencias de nodos personalizados existentes)
comfy node uv-sync

# Hacer --uv-compile el valor predeterminado
comfy manager uv-compile-default true

Gestión de Snapshots de Nodos

comfy node save-snapshot                           # Guardar el snapshot actual
comfy node restore-snapshot <snapshot_name>        # Restaurar un snapshot guardado

Gestión de Dependencias

comfy node install-deps --workflow=workflow.json   # Desde JSON de workflow
comfy node install-deps --workflow=workflow.png    # Desde PNG de workflow
comfy node install-deps --deps=dependencies.json   # Desde archivo JSON de dependencias
comfy node deps-in-workflow --workflow=workflow.json --output=deps.json

Solución de Problemas de Nodos (Bisección)

Identificar qué nodo personalizado está causando un error:

comfy node bisect start                            # Iniciar sesión de bisección
comfy node bisect good                             # Marcar estado actual como bueno
comfy node bisect bad                              # Marcar estado actual como malo
comfy node bisect reset                            # Reiniciar sesión

## Generar Imágenes Sin un JSON de Flujo de Trabajo

Comfy CLI puede llamar directamente a modelos de imagen y video de socios: no se requiere un grafo de flujo de trabajo.

```bash
comfy generate --prompt "a cat on a beach" --model flux/schnell
comfy generate --prompt "anime girl" --model stability/stable-diffusion-3.5
comfy generate --prompt "city street" --model ideogram/ideogram-v2

Los proveedores compatibles incluyen: Flux, Ideogram, DALL·E, Recraft, Stability, Gemini, Kling, Luma, Runway, Pika, Vidu, Hailuo, Seedance, y más.

Ruta a la Nube

Ejecute cualquier flujo de trabajo en Comfy Cloud (no se requiere GPU local):

comfy launch -- --where cloud
# or
comfy generate --model recraft/recraft-v3 --where cloud

Salida Estructurada para Agentes

Cada comando admite --json para salida legible por máquina: ideal para integración con CI/CD y agentes de IA:

comfy generate --prompt "a cat" --model flux/schnell --json

## Administración de Modelos

### Descargar Modelos

```bash
# Desde Hugging Face
comfy model download --url https://huggingface.co/runwayml/stable-diffusion-v1-5/resolve/main/v1-5-pruned.safetensors --relative-path models/checkpoints

# Desde CivitAI
comfy model download --url https://civitai.com/api/download/models/123456 --relative-path models/checkpoints

# Con token de API
comfy model download --url https://civitai.com/api/download/models/123456 --set-civitai-api-token TU_TOKEN

Los tokens de API también se pueden configurar mediante variables de entorno (CIVITAI_API_TOKEN, HF_API_TOKEN), lo cual es más seguro para entornos CI/CD.

Gestionar Modelos

comfy model list                                  # Listar modelos en la ruta predeterminada
comfy model list --relative-path models/loras     # Listar en una subcarpeta
comfy model remove --model-names "model.safetensors"  # Eliminar un modelo

## Gestión de ComfyUI-Manager

```bash
comfy manager disable-gui                         # Deshabilitar GUI del Manager
comfy manager enable-gui                          # Habilitar GUI del Manager
comfy manager clear                               # Limpiar acciones de inicio reservadas

## Información del Entorno

```bash
comfy env                                         # Muestra información detallada del entorno
comfy tracking status                             # Verifica la configuración de seguimiento
comfy tracking disable                            # Deshabilita el seguimiento de uso
comfy tracking enable                             # Habilita el seguimiento de uso

## Funciones Avanzadas

### comfy-lock.yaml (Beta)

Use un archivo `comfy-lock.yaml` para gestionar las dependencias del proyecto:

```yaml
basic:

models:
  - model: SD1.5 Base
    url: https://huggingface.co/...
    paths:
      - path: models/checkpoints
    hashes:
      - hash: abc123...
        type: SHA256
    type: checkpoint

custom_nodes:
  git_custom_nodes:
    https://github.com/user/ComfyUI-Node:
      disabled: false
      hash: a1b2c3d...

## Escenarios de uso comunes

### Gestión del entorno de desarrollo

```bash
# Crear espacio de trabajo para desarrollo estable
comfy --workspace=~/dev/comfyui-stable install

# Crear espacio de trabajo para funciones experimentales
comfy --workspace=~/dev/comfyui-experimental install

# Instalar nodos experimentales
comfy --workspace=~/dev/comfyui-experimental node install ComfyUI-AnimateDiff-Evolved

Gestión de dependencias del proyecto

# Crear una instantánea para un proyecto
comfy node save-snapshot my-project-v1

# Restaurar dependencias del proyecto
comfy node restore-snapshot my-project-v1

# Instalar dependencias del flujo de trabajo
comfy node install-deps --workflow=project.json

## Solución de problemas

### Problemas comunes

1. **Problemas con la ruta del espacio de trabajo**
   ```bash
   comfy which              # Verificar espacio de trabajo actual
   comfy set-default /ruta  # Restablecer a la ruta correcta

Conflictos de nodos

comfy node bisect start  # Usar bisect para localizar el nodo problemático

Problemas de permisos

ls -la ~/comfy           # Verificar permisos del directorio