cli-anything-comfyui について
cli-anything-comfyuiは、ComfyUI REST API経由で画像生成ワークフローを管理するコマンドラインツールです。AIエージェントや上級ユーザー向けに、キューの監視、モデルの確認、画像のダウンロードを提供し、エージェントが扱えるJSON出力にも対応します。
主な機能
- 01ワークフローの作成と検証
- 02生成キューの登録と監視
- 03モデルとノードタイプの確認
- 04生成画像の一覧表示とダウンロード
- 05サーバー状態とリソース使用量の確認
活用シーン
- 01コマンドラインから画像生成を依頼
- 02保留中のタスクと実行履歴を確認
- 03利用可能なモデルやノードタイプを検索
- 04特定の実行で生成した画像を取得
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ hkuds/ cli-anything --skill cli-anything-comfyuiインストール後、Claude Code で/cli-anything-comfyuiを入力して読み込まれたか確認します。
詳細
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 で実行されている必要があります
使用方法
基本コマンド
# Show help
cli-anything-comfyui --help
# Start interactive REPL mode
cli-anything-comfyui repl
# Check server stats
cli-anything-comfyui system stats
# Run with JSON output (for agent consumption)
cli-anything-comfyui --json system stats
REPL モード
探索的な用途向けに対話型セッションを開始します:
cli-anything-comfyui repl
# Enter commands interactively with tab-completion and history
コマンドグループ
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 サーバー情報と拡張機能を表示します |
例
システムステータスを確認する
# Server stats
cli-anything-comfyui system stats
# Server info
cli-anything-comfyui system info
利用可能なモデルを検出する
# List checkpoints
cli-anything-comfyui models checkpoints
# List LoRAs
cli-anything-comfyui models loras
# List all node types
cli-anything-comfyui models list-nodes
生成をキューに登録して監視する
# Queue a workflow
cli-anything-comfyui queue prompt --workflow my_workflow.json
# Check queue status
cli-anything-comfyui queue status
# View execution history
cli-anything-comfyui --json queue history
生成された画像をダウンロードする
# List generated images
cli-anything-comfyui images list
# Download a specific image
cli-anything-comfyui images download --filename ComfyUI_00001_.png --output ./out.png
# Download all images from a prompt
cli-anything-comfyui images download-all --prompt-id <id> --output-dir ./outputs
出力形式
すべてのコマンドは 2 つの出力モードをサポートしています:
- 人間が読みやすい形式 (デフォルト): テーブル、色、整形されたテキスト
- 機械が読み取れる形式 (
--jsonフラグ): エージェントが利用するための構造化 JSON
# Human output
cli-anything-comfyui system stats
# JSON output for agents
cli-anything-comfyui --json system stats
AI エージェント向け
この CLI をプログラムから使用する場合:
- 常に
--jsonフラグを使用する - 解析可能な出力のため - リターンコードを確認する - 0 は成功、非ゼロはエラー
- 失敗時は stderr を解析する - エラーメッセージを取得するため
- すべてのファイル操作に絶対パスを使用する
- 他のコマンドの前に
system statsで ComfyUI が実行中であることを確認する
詳細情報
- 完全なドキュメント: パッケージ内の README.md を参照してください
- テストカバレッジ: パッケージ内の TEST.md を参照してください
- 方法論: cli-anything-plugin 内の HARNESS.md を参照してください
バージョン
1.0.0
コメント
Markdown 対応