O que cli-anything-comfyui faz?
Gerenciamento de fluxos de trabalho de geração de imagens por IA via API REST do ComfyUI. Projetado para agentes de IA e usuários avançados que precisam enfileirar workflows, gerenciar modelos, baixar imagens geradas e monitorar a fila de geração sem uma interface gráfica.
Instalação
Esta CLI é instalada como parte do pacote cli-anything-comfyui:
pip install cli-anything-comfyui
Pré-requisitos:
- Python 3.10+
- ComfyUI deve estar instalado e em execução em http://localhost:8188
Uso
Comandos Básicos
# Mostrar ajuda
cli-anything-comfyui --help
# Iniciar modo REPL interativo
cli-anything-comfyui repl
# Verificar estatísticas do servidor
cli-anything-comfyui system stats
# Executar com saída JSON (para consumo por agente)
cli-anything-comfyui --json system stats
Modo REPL
Inicie uma sessão interativa para uso exploratório:
cli-anything-comfyui repl
# Insira comandos interativamente com conclusão por tab e histórico
Grupos de Comandos
Workflow
Comandos de gerenciamento de fluxos de trabalho.
| Comando | Descrição |
|---|---|
list | Listar fluxos de trabalho salvos |
load | Carregar um fluxo de trabalho de um arquivo JSON |
validate | Validar um JSON de fluxo de trabalho em relação ao grafo de nós do ComfyUI |
Queue
Gerenciamento da fila de geração.
| Comando | Descrição |
|---|---|
prompt | Enfileirar um fluxo de trabalho para execução |
status | Mostrar status atual da fila (em execução e pendentes) |
clear | Limpar a fila de geração |
history | Mostrar histórico de execução de prompts |
interrupt | Interromper a geração em execução |
Models
Comandos de descoberta de modelos.
| Comando | Descrição |
|---|---|
checkpoints | Listar modelos checkpoint disponíveis |
loras | Listar modelos LoRA disponíveis |
vaes | Listar modelos VAE disponíveis |
controlnets | Listar modelos ControlNet disponíveis |
node-info | Mostrar informações detalhadas para um tipo de nó específico |
list-nodes | Listar todos os tipos de nós disponíveis |
Images
Gerenciamento de imagens geradas.
| Comando | Descrição |
|---|---|
list | Listar imagens geradas no servidor |
download | Baixar uma imagem gerada específica |
download-all | Baixar todas as imagens de uma execução de prompt |
System
Status e informações do servidor.
| Comando | Descrição |
|---|---|
stats | Mostrar estatísticas do sistema ComfyUI (GPU, CPU, memória) |
info | Mostrar informações do servidor ComfyUI e extensões |
Exemplos
Verificar Status do Sistema
# Estatísticas do servidor
cli-anything-comfyui system stats
# Informações do servidor
cli-anything-comfyui system info
Descobrir Modelos Disponíveis
# Listar checkpoints
cli-anything-comfyui models checkpoints
# Listar LoRAs
cli-anything-comfyui models loras
# Listar todos os tipos de nós
cli-anything-comfyui models list-nodes
Enfileirar e Monitorar Geração
# Enfileirar um fluxo de trabalho
cli-anything-comfyui queue prompt --workflow meu_fluxo.json
# Verificar status da fila
cli-anything-comfyui queue status
# Visualizar histórico de execução
cli-anything-comfyui --json queue history
Baixar Imagens Geradas
# Listar imagens geradas
cli-anything-comfyui images list
# Baixar uma imagem específica
cli-anything-comfyui images download --filename ComfyUI_00001_.png --output ./out.png
# Baixar todas as imagens de um prompt
cli-anything-comfyui images download-all --prompt-id <id> --output-dir ./saidas
Formatos de Saída
Todos os comandos suportam modos de saída dupla:
- Legível para humanos (padrão): Tabelas, cores, texto formatado
- Legível para máquina (flag
--json): JSON estruturado para consumo por agentes
# Saída humana
cli-anything-comfyui system stats
# Saída JSON para agentes
cli-anything-comfyui --json system stats
Para Agentes de IA
Ao usar esta CLI programaticamente:
- Sempre use a flag
--jsonpara saída parseável - Verifique os códigos de retorno - 0 para sucesso, diferente de zero para erros
- Analise o stderr para mensagens de erro em caso de falha
- Use caminhos absolutos para todas as operações de arquivo
- Verifique se o ComfyUI está em execução com
system statsantes de outros comandos
Mais Informações
- Documentação completa: Veja README.md no pacote
- Cobertura de testes: Veja TEST.md no pacote
- Metodologia: Veja HARNESS.md no cli-anything-plugin
Versão
1.0.0