> ## Documentation Index
> Fetch the complete documentation index at: https://dripart-mintlify-b90d3c69.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# はじめに

### 概要

`comfy-cli` は、Comfy のインストールと管理を容易にする [コマンドラインツール](https://github.com/Comfy-Org/comfy-cli) です。

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

<CodeGroup>
  ```bash pip theme={null}
  pip install comfy-cli
  ```

  ```bash homebrew theme={null}
  brew tap Comfy-Org/comfy-cli
  brew install comfy-org/comfy-cli/comfy-cli
  ```
</CodeGroup>

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

```bash theme={null}
comfy --install-completion
```

### ComfyUI のインストール

Python 3.9 よりも新しい任意のバージョンを使用して仮想環境を作成します。

<CodeGroup>
  ```bash conda theme={null}
  conda create -n comfy-env python=3.11
  conda activate comfy-env
  ```

  ```bash venv theme={null}
  python3 -m venv comfy-env
  source comfy-env/bin/activate
  ```
</CodeGroup>

ComfyUI のインストール

```bash theme={null}
comfy install
```

<Warning>GPU に応じて、CUDA または ROCm のインストールが必要です。</Warning>

### ComfyUI の実行

```bash theme={null}
comfy launch
```

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

<Info>
  **`comfy generate` はベータ版です。** フラグ名、モデルエイリアス、出力形式はフィードバックに基づいて変更される可能性があります。基盤となるパートナーエンドポイントは安定していますが、その上にある CLI の操作性はまだ進化中です。フィードバックや問題は [comfy-cli GitHub リポジトリ](https://github.com/Comfy-Org/comfy-cli/issues) で報告してください。
</Info>

<Tip>
  `comfy generate` は、Comfy の [パートナーノード](/ja/tutorials/partner-nodes/overview) をターミナルやスクリプトから呼び出す最速の方法です。ComfyUI ワークフローに組み込むのと同じホスト型エンドポイントを、ワンショット CLI 呼び出しで利用できます。バッチジョブ、簡単な実験、フル ComfyUI グラフを立ち上げるにはオーバーキルな自動化パイプラインに最適です。
</Tip>

### 前提条件

* [Comfy API キーの作成](/ja/development/comfyui-server/api-key-integration)
* [アカウントへのクレジット追加](/ja/interface/credits)
* オプション：[パートナーノードと呼び出しごとの料金を確認](/ja/tutorials/partner-nodes/overview)

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

```bash theme={null}
export COMFY_API_KEY=comfyui-...   # または各呼び出しで --api-key を指定
```

### 初めての生成

```bash theme={null}
comfy generate flux-pro \
    --prompt "a cat on the moon, cinematic lighting" \
    --width 1024 --height 1024 \
    --download cat.png
```

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

### 人気のモデル

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

```bash theme={null}
# 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
```

### モデルの検索

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

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

ローカルファイルのパスを直接渡します — CLI が Comfy のストレージエンドポイントを通じてアップロードします（各パートナーの仕様に応じて、base64 エンコードされる場合もあります）：

```bash theme={null}
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 を複数回の呼び出しで再利用することもできます：

```bash theme={null}
comfy generate upload ./photo.jpg
# → 署名付き URL が出力され、--input_image として渡せる
```

<Note>
  アップロードされた参照アセットは **24 時間** 後に自動削除されます。Comfy 管理の GCS バケットに保存され、署名付き URL で提供されます。ほとんどのワークフロー（アップロード → 使用 → 完了）では透過的ですが、長時間実行されるパイプラインの場合は、各ジョブの前に再アップロードしてください。詳細は [リファレンス](/ja/comfy-cli/reference#upload) を参照してください。
</Note>

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

動画ジョブは非同期です — CLI はデフォルトでブロックし、準備ができるまでポーリングします：

```bash theme={null}
comfy generate kling \
    --prompt "a paper boat drifting on a river at dusk" \
    --duration 5 \
    --download boat.mp4
```

`--async` を渡すと、ジョブ ID を返して即座に戻り、後で再開できます：

```bash theme={null}
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 レスポンスを出力します：

```bash theme={null}
comfy generate dalle --prompt "a watercolor whale" --json | jq '.data[0].url'
```

コマンド、フラグ、モデルエイリアスの完全なリストは [リファレンス](/ja/comfy-cli/reference) を参照してください。

### カスタムノードの管理

```bash theme={null}
comfy node install <NODE_NAME>
```

カスタムノードのインストールには `cm-cli` を使用します。詳細については [ドキュメント](https://github.com/Comfy-Org/ComfyUI-Manager/blob/main/docs/en/cm-cli.md) を参照してください。

### モデルの管理

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

```bash theme={null}
comfy model download --url <url> --relative-path models/checkpoints
```

### コントリビューション

comfy-cli へのコントリビューションを歓迎します！提案、アイデア、バグ報告がある場合は、[GitHub リポジトリ](https://github.com/Comfy-Org/comfy-cli/issues) で Issue を作成してください。コードに貢献したい場合は、リポジトリをフォークしてプルリクエストを送信してください。

詳細については [開発ガイド](https://github.com/Comfy-Org/comfy-cli/blob/main/DEV_README.md) を参照してください。

### アナリティクス

ユーザーエクスペリエンスを向上させるために、CLI の使用状況を追跡しています。以下を実行することで、これを無効にできます：

```bash theme={null}
comfy tracking disable
```

トラッキングを再度有効にするには、以下を実行してください：

```bash theme={null}
comfy tracking enable
```