Skip to content
Ayuda a Construir una Mejor Base de Conocimientos de ComfyUI Conviértete en Patrocinador

Guía Completa de Usuario de Comfy CLI

Comfy CLI es la herramienta oficial de línea de comandos proporcionada por ComfyUI. No solo simplifica el proceso de instalación de ComfyUI, sino que también ofrece potentes capacidades de gestión. Esta guía cubrirá de manera integral todas las características de Comfy CLI.

Comandos Básicos

Instalación y Configuración

# Instalar comfy-cli
pip install comfy-cli
 
# Habilitar autocompletado de línea de comandos
comfy --install-completion
 
# Instalar ComfyUI
comfy install
 
# Ejecutar ComfyUI
comfy launch

Gestión de Espacios de Trabajo

comfy-cli soporta la gestión de múltiples espacios de trabajo de ComfyUI, permitiéndote mantener diferentes entornos de ComfyUI simultáneamente:

Operaciones Básicas de Espacios de Trabajo

# Verificar ruta del espacio de trabajo actual
comfy which
 
# Establecer espacio de trabajo por defecto
comfy set-default /ruta/a/tu/espacio-de-trabajo
 
# Establecer espacio de trabajo por defecto con parámetros de ejecución
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

1. Especificar espacio de trabajo:

# Ejecutar ComfyUI en espacio de trabajo específico
comfy --workspace=/ruta/al/espacio-de-trabajo launch
 
# Instalar nodos en espacio de trabajo específico
comfy --workspace=/ruta/al/espacio-de-trabajo node install ComfyUI-Impact-Pack

2. Usar espacio de trabajo reciente:

# Ejecutar ComfyUI usado más recientemente
comfy --recent launch
 
# Actualizar nodos en espacio de trabajo reciente
comfy --recent node update all

3. Operar en directorio actual:

# Instalar nodos en ComfyUI del directorio actual
comfy --here node install ComfyUI-Impact-Pack
 
# Ejecutar ComfyUI en directorio actual
comfy --here launch
 
# Verificar si el directorio actual tiene ComfyUI
comfy --here which

Restricciones de Opciones de Espacios de Trabajo

Nota Importante: Las opciones --workspace, --recent y --here no pueden usarse simultáneamente.

Reglas de Prioridad de Espacios de Trabajo

Cuando no especificas explícitamente un espacio de trabajo, comfy-cli seleccionará automáticamente basándose en la siguiente prioridad:

  1. Ruta ComfyUI por defecto especificada vía comfy set-default <path>
  2. ComfyUI ejecutado o instalado más recientemente
  3. ComfyUI en el directorio actual

Ejemplos de Uso Práctico

Escenario 1: Crear Entornos Independientes para Diferentes Proyectos

# Crear espacio de trabajo para Proyecto A
comfy --workspace=~/proyectos/proyectoA install
 
# Crear espacio de trabajo para Proyecto B
comfy --workspace=~/proyectos/proyectoB install
 
# Instalar nodos específicos en Proyecto A
comfy --workspace=~/proyectos/proyectoA node install ComfyUI-AnimateDiff-Evolved
 
# Instalar diferentes nodos en Proyecto B
comfy --workspace=~/proyectos/proyectoB node install ComfyUI-Impact-Pack

Escenario 2: Cambio Rápido de Entornos

# Establecer espacio de trabajo frecuentemente usado como predeterminado
comfy set-default ~/proyectos/espacio-de-trabajo-principal
 
# Trabajar temporalmente en otro espacio de trabajo
comfy --workspace=~/proyectos/espacio-de-trabajo-prueba launch
 
# Volver al espacio de trabajo predeterminado
comfy launch

Opciones de Ejecución

ComfyUI proporciona ricas opciones de ejecución para satisfacer diferentes requisitos:

Ejecución Básica

# Ejecución predeterminada
comfy launch
 
# Ejecutar en segundo plano
comfy launch --background
 
# Detener instancia en segundo plano
comfy stop

Configuración de Red

# Especificar dirección de escucha y puerto
comfy launch -- --listen 0.0.0.0 --port 8080
 
# Permitir acceso externo
comfy launch -- --listen 0.0.0.0

Optimización de Rendimiento

# Usar modo CPU
comfy launch -- --cpu
 
# Modo VRAM baja
comfy launch -- --lowvram
 
# Modo VRAM ultra-baja
comfy launch -- --novram
 
# Habilitar descarga de modelo a CPU
comfy launch -- --cpu-vae

Gestión de Nodos Personalizados

Visualización de Información de Nodos

# Mostrar toda la información de nodos disponible
comfy node show all
 
# Visualización simple de nodos instalados
comfy node simple-show installed
 
# Mostrar nodos habilitados
comfy node show enabled
 
# Mostrar nodos no instalados
comfy node show not-installed
 
# Mostrar nodos deshabilitados
comfy node show disabled
 
# Mostrar nodos de canal específico
comfy node show all --channel recent

Instalación y Actualizaciones de Nodos

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

Gestión de Instantáneas de Nodos

La funcionalidad de instantáneas te ayuda a guardar y restaurar estados de configuración de nodos:

# Guardar instantánea de nodos
comfy node save-snapshot
 
# Ver lista de instantáneas
comfy node show snapshot-list
 
# Restaurar instantánea de nodos
comfy node restore-snapshot <nombre_instantánea>

Gestión de Dependencias

# Instalar dependencias desde archivo de flujo de trabajo
comfy node install-deps --workflow=workflow.json
 
# Instalar dependencias desde archivo PNG de flujo de trabajo
comfy node install-deps --workflow=workflow.png
 
# Instalar desde archivo JSON de dependencias
comfy node install-deps --deps=dependencies.json
 
# Generar archivo de dependencias de flujo de trabajo
comfy node deps-in-workflow --workflow=workflow.json --output=deps.json

Solución de Problemas de Nodos (Bisect)

Cuando encuentres conflictos o problemas de nodos, usa la característica bisect para identificar rápidamente nodos problemáticos:

# Iniciar sesión de solución de problemas
comfy node bisect start
 
# Marcar estado actual como bueno
comfy node bisect good
 
# Marcar estado actual como problemático
comfy node bisect bad
 
# Reiniciar sesión de solución de problemas
comfy node bisect reset

Gestión de Modelos

Descargas de Modelos

# Descargar modelos desde URL (soporta CivitAI, Hugging Face, etc.)
comfy model download --url https://huggingface.co/model/url
 
# Descargar a ruta relativa específica
comfy model download --url https://civitai.com/api/download/models/123456 --relative-path models/checkpoints
 
# Establecer Token API de CivitAI (para descargar modelos que requieren login)
comfy model download --url https://civitai.com/api/download/models/123456 --set-civitai-api-token TU_TOKEN
 
# Combinar múltiples opciones
comfy model download --url https://huggingface.co/runwayml/stable-diffusion-v1-5/resolve/main/v1-5-pruned.safetensors --relative-path models/checkpoints

Gestión de Modelos

# Listar todos los modelos en ruta predeterminada
comfy model list
 
# Listar modelos en ruta específica
comfy model list --relative-path models/loras
 
# Eliminar modelos específicos
comfy model remove --model-names "model1.safetensors,model2.ckpt"
 
# Eliminar modelos de ruta específica
comfy model remove --relative-path models/checkpoints --model-names "old_model.ckpt"

Fuentes de Modelos Soportadas

  • Hugging Face: Usar URLs directas de archivos
  • CivitAI: Usar URLs de API de descarga de modelos
  • Otros enlaces directos: Cualquier URL de archivo de modelo directamente descargable

Gestión de ComfyUI-Manager

comfy-cli también puede gestionar configuraciones de ComfyUI-Manager:

# Deshabilitar GUI de ComfyUI-Manager (menú y servidor)
comfy manager disable-gui
 
# Habilitar GUI de ComfyUI-Manager
comfy manager enable-gui
 
# Limpiar acciones de inicio reservadas
comfy manager clear

Información del Entorno

Ver información detallada sobre el entorno ComfyUI actual:

# Mostrar información del entorno incluyendo estado de ejecución, espacio de trabajo, etc.
comfy env
 
# Verificar estado de configuraciones de seguimiento
comfy tracking status
 
# Deshabilitar seguimiento de uso
comfy tracking disable
 
# Habilitar seguimiento de uso
comfy tracking enable

Características Avanzadas

Característica Beta: comfy-lock.yaml

comfy-cli soporta el uso de archivos comfy-lock.yaml para gestionar dependencias de proyecto:

basic:
 
models:
  - model: [Nombre del Modelo]
    url: [URL fuente del modelo, ej., https://huggingface.co/...]
    paths: [Lista de rutas del modelo]
      - path: [Ruta del modelo]
      - path: [Ruta del modelo]
    hashes: [Hashes del modelo]
      - hash: [Valor hash]
        type: [AutoV1, AutoV2, SHA256, CRC32, Blake3]
    type: [Tipo de modelo, ej., diffuser, lora, etc.]
 
# Compatible con instantáneas .yaml de ComfyUI-Manager
custom_nodes:
  comfyui: [hash de commit]
  file_custom_nodes:
  - disabled: [bool]
    filename: [nombre de archivo .py]
    ...
  git_custom_nodes:
    [git-url]:
      disabled: [bool]
      hash: [hash de commit]
    ...

Escenarios de Uso Comunes

Gestión de Entornos de Desarrollo

# Crear entorno de desarrollo
comfy --workspace=~/dev/comfyui-dev install
 
# Crear entorno de prueba
comfy --workspace=~/test/comfyui-test install
 
# Instalar nodos experimentales en entorno de desarrollo
comfy --workspace=~/dev/comfyui-dev node install experimental-node
 
# Cambiar rápidamente a entorno de prueba para testear
comfy --workspace=~/test/comfyui-test launch

Gestión de Dependencias de Proyecto

# Crear instantánea de dependencias para proyecto
comfy node save-snapshot proyecto-v1.0
 
# Instalar dependencias de flujo de trabajo del proyecto
comfy node install-deps --workflow=flujo-trabajo-proyecto.json
 
# Restaurar a dependencias de versión específica
comfy node restore-snapshot proyecto-v1.0

Gestión Automatizada de Modelos

# Descargar por lotes modelos requeridos para proyecto
comfy model download --url https://huggingface.co/model1 --relative-path models/checkpoints
comfy model download --url https://huggingface.co/model2 --relative-path models/loras
 
# Limpiar modelos antiguos
comfy model remove --model-names "old_model1.ckpt,old_model2.safetensors"

Solución de Problemas

Problemas Comunes

  1. Problemas de Ruta de Espacio de Trabajo

    # Verificar espacio de trabajo actual
    comfy which
     
    # Si la ruta es incorrecta, reiniciarla
    comfy set-default /ruta/correcta
  2. Problemas de Conflicto de Nodos

    # Usar característica bisect para localizar problemas
    comfy node bisect start
    # Marcar estado normal/anormal según se indique
  3. Problemas de Permisos

    # Asegurar permisos suficientes
    ls -la ~/comfy

Enlaces Relacionados