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:
- Ruta ComfyUI por defecto especificada vía
comfy set-default <path>
- ComfyUI ejecutado o instalado más recientemente
- 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
-
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
-
Problemas de Conflicto de Nodos
# Usar característica bisect para localizar problemas comfy node bisect start # Marcar estado normal/anormal según se indique
-
Problemas de Permisos
# Asegurar permisos suficientes ls -la ~/comfy
Enlaces Relacionados
- Repositorio GitHub de Comfy CLI
- Documentación Oficial de Comfy CLI
- Guía de Instalación de ComfyUI en Linux
- Repositorio Oficial de ComfyUI