Comfy CLI: Instalar, Iniciar y Gestionar ComfyUI desde la Terminal

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

# 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

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.

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

# 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

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

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:

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

# 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

Problemas con la ruta del espacio de trabajo

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