メインコンテンツへスキップ

​
概要

comfy-cli は、Comfy のインストールと管理を容易にする コマンドラインツール です。 以下の 2 つの機能を提供します。
  1. ローカル ComfyUI の管理 — ComfyUI とそのカスタムノードのインストール、起動、更新、スナップショット、バイセクトが可能です。
  2. ホスト型パートナーノードを直接呼び出し — Seedance、Nano Banana（Gemini）、Grok、Flux、Ideogram、DALL·E、Recraft、Stability、Kling、Luma、Runway、Pika、Vidu、Hailuo、Moonvalley などから、1 つのコマンドで画像や動画を生成できます。ローカル ComfyUI やワークフロー JSON は必要ありません。

​
CLI のインストール

pip install comfy-cli
シェルの自動補完を有効にするには、以下のコマンドを実行します： 
comfy --install-completion

​
ComfyUI のインストール

Python 3.9 よりも新しい任意のバージョンを使用して仮想環境を作成します。 
conda create -n comfy-env python=3.11
conda activate comfy-env
ComfyUI のインストール 
comfy install
GPU に応じて、CUDA または ROCm のインストールが必要です。

​
ComfyUI の実行

comfy launch

​
comfy generate でパートナーノードを直接呼び出す（Beta）

comfy generate はベータ版です。 フラグ名、モデルエイリアス、出力形式はフィードバックに基づいて変更される可能性があります。基盤となるパートナーエンドポイントは安定していますが、その上にある CLI の操作性はまだ進化中です。フィードバックや問題は comfy-cli GitHub リポジトリ で報告してください。
comfy generate は、Comfy の パートナーノード をターミナルやスクリプトから呼び出す最速の方法です。ComfyUI ワークフローに組み込むのと同じホスト型エンドポイントを、ワンショット CLI 呼び出しで利用できます。バッチジョブ、簡単な実験、フル ComfyUI グラフを立ち上げるにはオーバーキルな自動化パイプラインに最適です。

​
前提条件

キーを一度設定すれば、あとは実行するだけです： 
export COMFY_API_KEY=comfyui-...   # または各呼び出しで --api-key を指定

​
初めての生成

comfy generate flux-pro \
    --prompt "a cat on the moon, cinematic lighting" \
    --width 1024 --height 1024 \
    --download cat.png
これだけです — CLI がローカルファイルの入力をアップロードし、ジョブを送信し、準備ができるまでポーリングして、結果を cat.png に保存します。

​
人気のモデル

よく使われるパートナーモデルの一部を、1 行で呼び出すことができます： 
# Nano Banana（Google Gemini Flash Image）— テキストから画像へ、およびプロンプト駆動の編集
comfy generate nano-banana \
    --prompt "a watercolor of a sleeping fox" \
    --download fox.png

# 同じエイリアス、今度は画像編集 — --image で参照画像を渡す（繰り返し可能）：
comfy generate nano-banana \
    --prompt "add a top hat" \
    --image ./cat.png \
    --download edited.png

# Gemini のバリアントを選択：
comfy generate nano-banana \
    --prompt "neon city skyline" \
    --model gemini-3-pro-image-preview \
    --download city.png

# Seedance（ByteDance）— テキストから動画へ、最大 1080p / 12 秒
comfy generate seedance \
    --prompt "a hummingbird hovering over a flower" \
    --resolution 1080p --duration 5 \
    --download hummingbird.mp4

# Seedance 画像から動画へ — lite/i2v バリアントを選んで最初のフレームを渡す
comfy generate seedance \
    --model seedance-1-0-lite-i2v-250428 \
    --prompt "the wave crests and crashes" \
    --image ./still.jpg \
    --download wave.mp4

# Grok（xAI）— 画像生成と編集
comfy generate grok --prompt "a cyberpunk street market at night" --download street.png
comfy generate grok-edit --prompt "swap the umbrella for a parasol" --image ./photo.jpg --download out.png

# Grok 動画
comfy generate grok-video --prompt "a paper plane gliding through a cathedral" --download flight.mp4

​
モデルの検索

comfy generate list                            # 利用可能な全モデル
comfy generate list --category text-to-video   # カテゴリでフィルタ
comfy generate list --partner kling            # パートナーでフィルタ
comfy generate schema flux-kontext             # 1 つのモデルのパラメータを確認

​
参照画像を使った画像編集

ローカルファイルのパスを直接渡します — CLI が Comfy のストレージエンドポイントを通じてアップロードします（各パートナーの仕様に応じて、base64 エンコードされる場合もあります）： 
comfy generate flux-kontext \
    --prompt "add a top hat and a monocle" \
    --input_image ./photo.jpg \
    --download out.png

comfy generate ideogram-edit \
    --image cat.png --mask mask.png \
    --prompt "add sunglasses" \
    --rendering_speed TURBO \
    --download edited.png
一度アップロードして、その署名付き URL を複数回の呼び出しで再利用することもできます： 
comfy generate upload ./photo.jpg
# → 署名付き URL が出力され、--input_image として渡せる
アップロードされた参照アセットは 24 時間 後に自動削除されます。Comfy 管理の GCS バケットに保存され、署名付き URL で提供されます。ほとんどのワークフロー（アップロード → 使用 → 完了）では透過的ですが、長時間実行されるパイプラインの場合は、各ジョブの前に再アップロードしてください。詳細は リファレンス を参照してください。

​
動画生成（非同期ジョブ）

動画ジョブは非同期です — CLI はデフォルトでブロックし、準備ができるまでポーリングします： 
comfy generate kling \
    --prompt "a paper boat drifting on a river at dusk" \
    --duration 5 \
    --download boat.mp4
--async を渡すと、ジョブ ID を返して即座に戻り、後で再開できます： 
comfy generate luma --prompt "neon koi swimming through clouds" --aspect_ratio 16:9 --async
# → ジョブ ID を出力；後で再開：
comfy generate resume luma <job_id> --download out.mp4

​
JSON 出力を使ったスクリプト

パイプラインでは、--json で生の API レスポンスを出力します： 
comfy generate dalle --prompt "a watercolor whale" --json | jq '.data[0].url'
コマンド、フラグ、モデルエイリアスの完全なリストは リファレンス を参照してください。

​
カスタムノードの管理

comfy node install <NODE_NAME>
カスタムノードのインストールには cm-cli を使用します。詳細については ドキュメント を参照してください。

​
モデルの管理

comfy-cli を使用したモデルのダウンロードは簡単です。以下を実行するだけです： 
comfy model download --url <url> --relative-path models/checkpoints

​
コントリビューション

comfy-cli へのコントリビューションを歓迎します！提案、アイデア、バグ報告がある場合は、GitHub リポジトリ で Issue を作成してください。コードに貢献したい場合は、リポジトリをフォークしてプルリクエストを送信してください。 詳細については 開発ガイド を参照してください。

​
アナリティクス

ユーザーエクスペリエンスを向上させるために、CLI の使用状況を追跡しています。以下を実行することで、これを無効にできます： 
comfy tracking disable
トラッキングを再度有効にするには、以下を実行してください： 
comfy tracking enable