¿Qué hace cli-anything-comfyui?
Gestión de flujos de trabajo de generación de imágenes mediante IA a través de la API REST de ComfyUI. Diseñado para agentes de IA y usuarios avanzados que necesitan encolar flujos de trabajo, gestionar modelos, descargar imágenes generadas y monitorear la cola de generación sin una interfaz gráfica.
Instalación
Esta CLI se instala como parte del paquete cli-anything-comfyui:
pip install cli-anything-comfyui
Requisitos previos:
- Python 3.10+
- ComfyUI debe estar instalado y ejecutándose en http://localhost:8188
Uso
Comandos básicos
# Mostrar ayuda
cli-anything-comfyui --help
# Iniciar modo REPL interactivo
cli-anything-comfyui repl
# Ver estadísticas del servidor
cli-anything-comfyui system stats
# Ejecutar con salida JSON (para consumo por agentes)
cli-anything-comfyui --json system stats
Modo REPL
Inicia una sesión interactiva para uso exploratorio:
cli-anything-comfyui repl
# Introduce comandos de forma interactiva con autocompletado y historial
Grupos de comandos
Workflow (Flujo de trabajo)
Comandos de gestión de flujos de trabajo.
| Comando | Descripción |
|---|---|
list | Listar flujos de trabajo guardados |
load | Cargar un flujo de trabajo desde un archivo JSON |
validate | Validar un JSON de flujo de trabajo contra el grafo de nodos de ComfyUI |
Queue (Cola)
Comandos de gestión de la cola de generación.
| Comando | Descripción |
|---|---|
prompt | Encolar un flujo de trabajo para ejecución |
status | Mostrar estado actual de la cola (en ejecución y pendientes) |
clear | Limpiar la cola de generación |
history | Mostrar historial de ejecución de prompts |
interrupt | Interrumpir la generación en curso |
Models (Modelos)
Comandos de descubrimiento de modelos.
| Comando | Descripción |
|---|---|
checkpoints | Listar modelos checkpoint disponibles |
loras | Listar modelos LoRA disponibles |
vaes | Listar modelos VAE disponibles |
controlnets | Listar modelos ControlNet disponibles |
node-info | Mostrar información detallada de un tipo de nodo específico |
list-nodes | Listar todos los tipos de nodos disponibles |
Images (Imágenes)
Gestión de imágenes generadas.
| Comando | Descripción |
|---|---|
list | Listar imágenes generadas en el servidor |
download | Descargar una imagen generada específica |
download-all | Descargar todas las imágenes de una ejecución de prompt |
System (Sistema)
Estado e información del servidor.
| Comando | Descripción |
|---|---|
stats | Mostrar estadísticas del sistema de ComfyUI (GPU, CPU, memoria) |
info | Mostrar información del servidor ComfyUI y extensiones |
Ejemplos
Verificar el estado del sistema
# Estadísticas del servidor
cli-anything-comfyui system stats
# Información del servidor
cli-anything-comfyui system info
Descubrir modelos disponibles
# Listar checkpoints
cli-anything-comfyui models checkpoints
# Listar LoRAs
cli-anything-comfyui models loras
# Listar todos los tipos de nodos
cli-anything-comfyui models list-nodes
Encolar y monitorear la generación
# Encolar un flujo de trabajo
cli-anything-comfyui queue prompt --workflow mi_flujo.json
# Verificar el estado de la cola
cli-anything-comfyui queue status
# Ver el historial de ejecuciones
cli-anything-comfyui --json queue history
Descargar imágenes generadas
# Listar imágenes generadas
cli-anything-comfyui images list
# Descargar una imagen específica
cli-anything-comfyui images download --filename ComfyUI_00001_.png --output ./salida.png
# Descargar todas las imágenes de un prompt
cli-anything-comfyui images download-all --prompt-id <id> --output-dir ./salidas
Formatos de salida
Todos los comandos admiten dos modos de salida:
- Legible por humanos (predeterminado): Tablas, colores, texto formateado
- Legible por máquina (bandera
--json): JSON estructurado para consumo por agentes
# Salida legible por humanos
cli-anything-comfyui system stats
# Salida JSON para agentes
cli-anything-comfyui --json system stats
Para agentes de IA
Al usar esta CLI de forma programática:
- Usa siempre la bandera
--jsonpara salida analizable - Verifica los códigos de retorno - 0 para éxito, distinto de cero para errores
- Analiza stderr para mensajes de error en caso de fallo
- Usa rutas absolutas para todas las operaciones con archivos
- Verifica que ComfyUI esté en ejecución con
system statsantes de otros comandos
Más información
- Documentación completa: Consulta README.md en el paquete
- Cobertura de pruebas: Consulta TEST.md en el paquete
- Metodología: Consulta HARNESS.md en cli-anything-plugin
Versión
1.0.0