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

概要

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 のインストール

シェルの自動補完を有効にするには、以下のコマンドを実行します:

ComfyUI のインストール

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

ComfyUI の実行

comfy generate でパートナーノードを直接呼び出す(Beta)

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

前提条件

キーを一度設定すれば、あとは実行するだけです:

初めての生成

これだけです — CLI がローカルファイルの入力をアップロードし、ジョブを送信し、準備ができるまでポーリングして、結果を cat.png に保存します。

人気のモデル

よく使われるパートナーモデルの一部を、1 行で呼び出すことができます:

モデルの検索

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

ローカルファイルのパスを直接渡します — CLI が Comfy のストレージエンドポイントを通じてアップロードします(各パートナーの仕様に応じて、base64 エンコードされる場合もあります):
一度アップロードして、その署名付き URL を複数回の呼び出しで再利用することもできます:
アップロードされた参照アセットは 24 時間 後に自動削除されます。Comfy 管理の GCS バケットに保存され、署名付き URL で提供されます。ほとんどのワークフロー(アップロード → 使用 → 完了)では透過的ですが、長時間実行されるパイプラインの場合は、各ジョブの前に再アップロードしてください。詳細は リファレンス を参照してください。

動画生成(非同期ジョブ)

動画ジョブは非同期です — CLI はデフォルトでブロックし、準備ができるまでポーリングします:
--async を渡すと、ジョブ ID を返して即座に戻り、後で再開できます:

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

パイプラインでは、--json で生の API レスポンスを出力します:
コマンド、フラグ、モデルエイリアスの完全なリストは リファレンス を参照してください。

カスタムノードの管理

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

モデルの管理

comfy-cli を使用したモデルのダウンロードは簡単です。以下を実行するだけです:

コントリビューション

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

アナリティクス

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