Comfy-Org/comfy-cli

comfy‑cli の役割

comfy‑cli は、AIモデル（Stable Diffusion, Flux, DALL·E など）を使用して画像、動画、その他のメディアを生成するためのオープンソースエンジンである ComfyUI の インストール、実行、および拡張 を支援する Python ベースのコマンドラインインターフェースです。ComfyUI のリポジトリを手動でクローンしたり、Python の依存関係をインストールしたり、JSON ワークフローファイルを調整したりする代わりに、comfy install、comfy run、または comfy generate といったシンプルなコマンドを入力するだけで済みます。

コア機能

機能	あなたにとっての意味
ワンコマンドでのインストールと起動	`comfy setup`（または `comfy install` + `comfy launch`）により、最新の ComfyUI コード、そのマネージャー、および必要なすべての Python パッケージを一度のステップでダウンロードします。
ダイレクトなモデル呼び出し	`comfy generate` を使用すると、UI ワークフローの JSON を作成することなく、パートナーの画像/動画ノード（Flux, DALL·E, Stability AI など）と通信できます。
カスタムノードの管理	`comfy node install <id>` や `comfy node update all` などのコマンドを使用して、Comfy Registry からカスタムノードパックをインストール、更新、スナップショット作成、または bisect（二分探索）できます。
高速な依存関係解決	`--fast-deps` または `--uv-compile` フラグを使用すると、`uv` リゾルバを使用してすべてのノードに対して単一のロックファイルを作成し、インストールを著しく高速化します。
モデルのダウンロード	CivitAI、Hugging Face、または任意の URL から、単一のコマンドでモデルをプルします。
ローカルまたはクラウドのワークフローを実行	`comfy run --workflow file.json --where cloud` は、ワークフローを Comfy Cloud に送信します（GPU は不要です）。同じコマンドは、ローカルで実行されている ComfyUI サーバーに対しても機能します。
エージェント向けの JSON 出力	`--json` を追加すると、すべてのコマンドが構造化されたエンベロープを出力し、LLM ベースのエージェント（Claude, Cursor など）がそれを解析して実行できるようになります。
クロスプラットフォーム	Windows, macOS, Linux で動作します。virtualenv, conda env, または `pipx` を介してインストール可能です。
シェル・オートコンプリート	`comfy --install-completion` により、すべてのサブコマンドとオプションのタブ補完が提供されます。

一般的なワークフロー

CLI のインストール – pip install comfy-cli (Python 3.10+)。
ComfyUI のセットアップ – comfy setup（対話型ウィザード）または comfy install。
ノードやモデルの追加 – comfy node install comfyui‑impact‑pack または comfy model download <url>。
生成の実行 – comfy generate --prompt "a cyberpunk city at night"（ローカル）または --where cloud を追加してホストされたサービス上で実行。
結果の取得 – comfy download <prompt_id> -o ./outputs。

なぜ重要なのか

ComfyUI は、AI 駆動のメディア作成において強力ですが、手動での作業が重いプラットフォームです。comfy‑cli は、セットアップ、依存関係の地獄、および JSON のみのワークフロー実行という摩擦を解消し、、開発者、CI パイプライン、およびプログラム的に画像生成を呼び出す必要がある AI エージェントにとって、このエンジンを使いやすくします。

クイックリファレンス（選択されたコマンド）

comfy install – ComfyUI + マネージャーをダウンロードします。
comfy launch – UI サーバーを起動します（デーモン化するには --background を追加）。
comfy generate – ターミナルからパートナーモデルを直接呼び出します。
comfy run --workflow FILE.json [--where cloud] – 保存されたワークフローを実行します。
comfy node install <registry‑id> – カスタムノードパックを追加します。
comfy update all – ComfyUI とインストールされたすべてのノードを更新します。
comfy cloud login / comfy cloud status – ホストされた Comfy Cloud アカウントを管理します。
comfy --json <subcommand> – LLM エージェント用の機械読取可能な出力です。

誰が使うべきか？

開発者 – インストール、CI テスト、または自動生成をスクリプト化したい人。
研究者 – 生成メディアの実験のために再現可能な環境をが必要とする人。
LLM 駆動のエージェント (Claude, Cursor など) – 画像作成をドライブするための安定した JSON インフェースを必要とする人。
アーティスト がターミナルに慣れており、ComfyUI を素早く立ち上げ、多くのモデルプロバイダーにアクセスしたい人。

詳細を学ぶには

GitHub リポジトリ – https://github.com/Comfy-Org/comfy-cli (README, issue tracker, CI status badges)。
ComfyUI プロジェクト – https://github.com/comfyanonymous/ComfyUI (この CLI がラップしているエンジン)。
Comfy Cloud – https://www.comfy.org/ ( --where cloud を介して使用されるホスト型 GPU サービス)。

All details above are taken directly from the project's README; no additional features have been inferred.