Que fait cli-anything-comfyui ?
Gestion de flux de travail de génération d'images IA via l'API REST de ComfyUI. Conçu pour les agents IA et les utilisateurs avancés qui souhaitent mettre en file d'attente des workflows, gérer les modèles, télécharger les images générées et surveiller la file d'attente sans interface graphique.
Installation
Cette CLI est installée dans le cadre du paquet cli-anything-comfyui :
pip install cli-anything-comfyui
Prérequis :
- Python 3.10+
- ComfyUI doit être installé et en cours d'exécution sur http://localhost:8188
Utilisation
Commandes de base
# Afficher l'aide
cli-anything-comfyui --help
# Démarrer le mode REPL interactif
cli-anything-comfyui repl
# Vérifier les statistiques du serveur
cli-anything-comfyui system stats
# Exécuter avec sortie JSON (pour consommation par agent)
cli-anything-comfyui --json system stats
Mode REPL
Démarrez une session interactive pour une utilisation exploratoire :
cli-anything-comfyui repl
# Entrez des commandes de manière interactive avec complétion par tabulation et historique
Groupes de commandes
Workflow
Commandes de gestion des flux de travail.
| Commande | Description |
|---|---|
list | Lister les workflows sauvegardés |
load | Charger un workflow depuis un fichier JSON |
validate | Valider un JSON de workflow par rapport au graphe de nœuds ComfyUI |
Queue
Gestion de la file d'attente de génération.
| Commande | Description |
|---|---|
prompt | Mettre un workflow en file d'attente pour exécution |
status | Afficher l'état actuel de la file d'attente (en cours et en attente) |
clear | Vider la file d'attente de génération |
history | Afficher l'historique d'exécution des prompts |
interrupt | Interrompre la génération en cours |
Models
Commandes de découverte de modèles.
| Commande | Description |
|---|---|
checkpoints | Lister les modèles de checkpoint disponibles |
loras | Lister les modèles LoRA disponibles |
vaes | Lister les modèles VAE disponibles |
controlnets | Lister les modèles ControlNet disponibles |
node-info | Afficher des informations détaillées pour un type de nœud spécifique |
list-nodes | Lister tous les types de nœuds disponibles |
Images
Gestion des images générées.
| Commande | Description |
|---|---|
list | Lister les images générées sur le serveur |
download | Télécharger une image générée spécifique |
download-all | Télécharger toutes les images d'une exécution de prompt |
System
Statut et informations du serveur.
| Commande | Description |
|---|---|
stats | Afficher les statistiques système ComfyUI (GPU, CPU, mémoire) |
info | Afficher les informations du serveur ComfyUI et les extensions |
Exemples
Vérifier l'état du système
# Statistiques du serveur
cli-anything-comfyui system stats
# Informations du serveur
cli-anything-comfyui system info
Découvrir les modèles disponibles
# Lister les checkpoints
cli-anything-comfyui models checkpoints
# Lister les LoRAs
cli-anything-comfyui models loras
# Lister tous les types de nœuds
cli-anything-comfyui models list-nodes
Mettre en file d'attente et surveiller la génération
# Mettre un workflow en file d'attente
cli-anything-comfyui queue prompt --workflow my_workflow.json
# Vérifier l'état de la file d'attente
cli-anything-comfyui queue status
# Afficher l'historique d'exécution
cli-anything-comfyui --json queue history
Télécharger les images générées
# Lister les images générées
cli-anything-comfyui images list
# Télécharger une image spécifique
cli-anything-comfyui images download --filename ComfyUI_00001_.png --output ./out.png
# Télécharger toutes les images d'un prompt
cli-anything-comfyui images download-all --prompt-id <id> --output-dir ./outputs
Formats de sortie
Toutes les commandes supportent deux modes de sortie :
- Lisible par l'humain (par défaut) : Tableaux, couleurs, texte formaté
- Lisible par machine (drapeau
--json) : JSON structuré pour consommation par un agent
# Sortie humaine
cli-anything-comfyui system stats
# Sortie JSON pour les agents
cli-anything-comfyui --json system stats
Pour les agents IA
Lorsque vous utilisez cette CLI par programme :
- Utilisez toujours le drapeau
--jsonpour une sortie analysable - Vérifiez les codes de retour - 0 pour succès, non nul pour erreur
- Analysez stderr pour les messages d'erreur en cas d'échec
- Utilisez des chemins absolus pour toutes les opérations de fichiers
- Vérifiez que ComfyUI est en cours d'exécution avec
system statsavant d'autres commandes
Plus d'informations
- Documentation complète : Voir README.md dans le paquet
- Couverture des tests : Voir TEST.md dans le paquet
- Méthodologie : Voir HARNESS.md dans cli-anything-plugin
Version
1.0.0