cli-anything-comfyui は何をしますか？
ComfyUI REST API 経由でAI画像生成ワークフローを管理します。GUIを使わずにワークフローのキュー投入、モデル管理、生成画像のダウンロード、生成キュー監視を行いたいAIエージェントやパワーユーザー向けに設計されています。
インストール
このCLIは cli-anything-comfyui パッケージの一部としてインストールされます:
pip install cli-anything-comfyui
前提条件:
- Python 3.10+
- ComfyUI がインストールされ、
http://localhost:8188で実行されていること
使い方
基本コマンド
# ヘルプを表示
cli-anything-comfyui --help
# 対話型REPLモードを開始
cli-anything-comfyui repl
# サーバーステータスを確認
cli-anything-comfyui system stats
# JSON出力で実行（エージェント向け）
cli-anything-comfyui --json system stats
REPLモード
探索的な使用のために対話型セッションを開始します:
cli-anything-comfyui repl
# タブ補完と履歴機能を使って対話的にコマンドを入力
コマンドグループ
Workflow（ワークフロー）
ワークフロー管理コマンド。
| コマンド | 説明 |
|---|---|
list | 保存済みワークフローを一覧表示 |
load | JSONファイルからワークフローを読み込み |
validate | ワークフローJSONをComfyUIノードグラフに対して検証 |
Queue（キュー）
生成キュー管理。
| コマンド | 説明 |
|---|---|
prompt | ワークフローを実行キューに投入 |
status | 現在のキュー状態（実行中および待機中）を表示 |
clear | 生成キューをクリア |
history | プロンプト実行履歴を表示 |
interrupt | 現在実行中の生成を中断 |
Models（モデル）
モデル探索コマンド。
| コマンド | 説明 |
|---|---|
checkpoints | 利用可能なチェックポイントモデルを一覧表示 |
loras | 利用可能なLoRAモデルを一覧表示 |
vaes | 利用可能なVAEモデルを一覧表示 |
controlnets | 利用可能なControlNetモデルを一覧表示 |
node-info | 特定のノードタイプの詳細情報を表示 |
list-nodes | 利用可能なすべてのノードタイプを一覧表示 |
Images（画像）
生成画像の管理。
| コマンド | 説明 |
|---|---|
list | サーバー上の生成画像を一覧表示 |
download | 特定の生成画像をダウンロード |
download-all | プロンプト実行結果のすべての画像をダウンロード |
System（システム）
サーバーステータスと情報。
| コマンド | 説明 |
|---|---|
stats | ComfyUIシステム統計（GPU、CPU、メモリ）を表示 |
info | ComfyUIサーバー情報と拡張機能を表示 |
使用例
システムステータスの確認
# サーバーステータス
cli-anything-comfyui system stats
# サーバー情報
cli-anything-comfyui system info
利用可能なモデルの探索
# チェックポイントを一覧表示
cli-anything-comfyui models checkpoints
# LoRAを一覧表示
cli-anything-comfyui models loras
# すべてのノードタイプを一覧表示
cli-anything-comfyui models list-nodes
生成のキュー投入と監視
# ワークフローをキューに投入
cli-anything-comfyui queue prompt --workflow my_workflow.json
# キュー状態を確認
cli-anything-comfyui queue status
# 実行履歴を表示
cli-anything-comfyui --json queue history
生成画像のダウンロード
# 生成画像を一覧表示
cli-anything-comfyui images list
# 特定の画像をダウンロード
cli-anything-comfyui images download --filename ComfyUI_00001_.png --output ./out.png
# プロンプトのすべての画像をダウンロード
cli-anything-comfyui images download-all --prompt-id <id> --output-dir ./outputs
出力形式
すべてのコマンドは2つの出力モードをサポートしています:
- 人間可読（デフォルト）: テーブル、色付き、整形テキスト
- 機械可読（
--jsonフラグ）: エージェントが消費する構造化JSON
# 人間向け出力
cli-anything-comfyui system stats
# エージェント向けJSON出力
cli-anything-comfyui --json system stats
AIエージェント向け
このCLIをプログラムから使用する場合:
- 常に
--jsonフラグを使用して解析可能な出力を取得する - 戻り値を確認する - 0は成功、0以外はエラー
- エラー発生時は stderr を解析してエラーメッセージを取得する
- ファイル操作には絶対パスを使用する
- 他のコマンドの前に
system statsで ComfyUI が実行中であることを確認する
詳細情報
- 完全なドキュメント: パッケージ内の README.md を参照
- テストカバレッジ: パッケージ内の TEST.md を参照
- 方法論: cli-anything-plugin 内の HARNESS.md を参照
バージョン
1.0.0