Was macht cli-anything-comfyui?
Verwaltung von KI-Bildgenerierungs-Workflows über die ComfyUI REST API. Entwickelt für KI-Agenten und Power-User, die Workflows einreihen, Modelle verwalten, generierte Bilder herunterladen und die Generierungswarteschlange ohne GUI überwachen müssen.
Installation
Dieses CLI wird als Teil des Pakets cli-anything-comfyui installiert:
pip install cli-anything-comfyui
Voraussetzungen:
- Python 3.10+
- ComfyUI muss installiert sein und unter http://localhost:8188 laufen
Verwendung
Grundlegende Befehle
# Hilfe anzeigen
cli-anything-comfyui --help
# Interaktiven REPL-Modus starten
cli-anything-comfyui repl
# Server-Statistiken prüfen
cli-anything-comfyui system stats
# Mit JSON-Ausgabe (für Agenten)
cli-anything-comfyui --json system stats
REPL-Modus
Startet eine interaktive Sitzung für den explorativen Gebrauch:
cli-anything-comfyui repl
# Befehle interaktiv mit Tab-Vervollständigung und Verlauf eingeben
Befehlsgruppen
Workflow
Befehle zur Workflow-Verwaltung.
| Befehl | Beschreibung |
|---|---|
list | Gespeicherte Workflows auflisten |
load | Workflow aus einer JSON-Datei laden |
validate | Workflow-JSON gegen den ComfyUI-Knotengraphen validieren |
Queue
Verwaltung der Generierungswarteschlange.
| Befehl | Beschreibung |
|---|---|
prompt | Workflow zur Ausführung einreihen |
status | Aktuellen Warteschlangenstatus anzeigen (laufend und wartend) |
clear | Generierungswarteschlange leeren |
history | Ausführungsverlauf der Prompts anzeigen |
interrupt | Aktuell laufende Generierung unterbrechen |
Models
Befehle zur Modellermittlung.
| Befehl | Beschreibung |
|---|---|
checkpoints | Verfügbare Checkpoint-Modelle auflisten |
loras | Verfügbare LoRA-Modelle auflisten |
vaes | Verfügbare VAE-Modelle auflisten |
controlnets | Verfügbare ControlNet-Modelle auflisten |
node-info | Detaillierte Informationen zu einem bestimmten Knotentyp anzeigen |
list-nodes | Alle verfügbaren Knotentypen auflisten |
Images
Verwaltung generierter Bilder.
| Befehl | Beschreibung |
|---|---|
list | Generierte Bilder auf dem Server auflisten |
download | Ein bestimmtes generiertes Bild herunterladen |
download-all | Alle Bilder einer Prompt-Ausführung herunterladen |
System
Serverstatus und -informationen.
| Befehl | Beschreibung |
|---|---|
stats | ComfyUI-Systemstatistiken anzeigen (GPU, CPU, Speicher) |
info | ComfyUI-Serverinformationen und Erweiterungen anzeigen |
Beispiele
Systemstatus prüfen
# Server-Statistiken
cli-anything-comfyui system stats
# Server-Informationen
cli-anything-comfyui system info
Verfügbare Modelle ermitteln
# Checkpoints auflisten
cli-anything-comfyui models checkpoints
# LoRAs auflisten
cli-anything-comfyui models loras
# Alle Knotentypen auflisten
cli-anything-comfyui models list-nodes
Generierung einreihen und überwachen
# Workflow einreihen
cli-anything-comfyui queue prompt --workflow my_workflow.json
# Warteschlangenstatus prüfen
cli-anything-comfyui queue status
# Ausführungsverlauf anzeigen
cli-anything-comfyui --json queue history
Generierte Bilder herunterladen
# Generierte Bilder auflisten
cli-anything-comfyui images list
# Ein bestimmtes Bild herunterladen
cli-anything-comfyui images download --filename ComfyUI_00001_.png --output ./out.png
# Alle Bilder eines Prompts herunterladen
cli-anything-comfyui images download-all --prompt-id <id> --output-dir ./outputs
Ausgabeformate
Alle Befehle unterstützen zwei Ausgabemodi:
- Menschenlesbar (Standard): Tabellen, Farben, formatierter Text
- Maschinenlesbar (
--json-Flag): Strukturiertes JSON für Agenten
# Menschliche Ausgabe
cli-anything-comfyui system stats
# JSON-Ausgabe für Agenten
cli-anything-comfyui --json system stats
Für KI-Agenten
Bei der programmatischen Nutzung dieses CLIs:
- Immer das
--json-Flag verwenden für parsebare Ausgabe - Rückgabecodes prüfen – 0 für Erfolg, ungleich 0 für Fehler
- stderr parsen für Fehlermeldungen bei Fehlern
- Absolute Pfade verwenden für alle Dateioperationen
- Sicherstellen, dass ComfyUI läuft mit
system statsvor anderen Befehlen
Weitere Informationen
- Vollständige Dokumentation: Siehe README.md im Paket
- Testabdeckung: Siehe TEST.md im Paket
- Methodik: Siehe HARNESS.md im cli-anything-plugin
Version
1.0.0