Comfy Agentのローカル版を試す入口は、Pythonパッケージのcomfy-agentです。2026年11月8日に確認した配布情報はプレリリースで、ComfyUIと同じPython環境へ導入し、--enable-agentを付けて起動する手順が案内されています。普段の制作環境をそのまま更新する前に、試す環境と戻し方を用意してください。
ローカル版の配布とDesktopの正式対応を分けて読む
PyPIでは11月6日付の配布を確認できる一方、公式のAgent総合案内にはローカル対応を予定として扱う記載が残っています。「パッケージを試せる」と「Desktopの全利用者が安定版として使える」は同じ状態ではありません。この記事は手動環境でプレリリースを検討する人向けです。
また、ローカルのComfyUIを操作できても、会話を処理するAIまで自分のPCだけで動くとは限りません。完全オフラインや無料の構成を求めている場合は、導入前に利用条件と通信先を確認します。
導入前にPythonと復元点を確認する
まず、通常のComfyUIが起動し、手元の小さなワークフローを実行できる状態を残します。Agent導入後に不具合が出ても、もともと動いていなかった構成との混同を避けられます。
- ComfyUIの版、起動コマンド、使用しているPythonのパスを記録する。
- ワークフローと設定を別の保存先へ退避する。
- 検証用環境を用意し、依存パッケージの一覧を保存する。
python -c "import sys; print(sys.executable)"
python -m pip freeze > before-agent-packages.txtここでのpythonはComfyUIを起動するPythonです。Portableの同梱PythonやDesktopの管理環境を使っているのに、OS側のPythonへインストールしても、起動するComfyUIからは見えません。pip freezeは依存の記録であり、モデルや画像を含むバックアップではありません。
プレリリースを入れてAgent付きで起動する
公式の配布ページでは次の導入方法が案内されています。実行前に配布元と対応条件を開き直し、検証用環境であることを確かめます。
python -m pip install --pre comfy-agent
python main.py --enable-agent後半は、手動インストールしたComfyUIのmain.pyがある場所で実行する例です。普段の起動に必要な引数まで消さないでください。配布ページにはOS別のwheelや追加構成も説明されていますが、最初から追加機能をすべて入れず、起動ログで読み込みを確認するところから始めます。
最初の依頼は説明と小さな変更に絞る
起動したら、制作途中の原本ではなく複製したワークフローを選びます。最初の依頼文は、たとえば次のように変更範囲を狭くできます。
このワークフローの入力から保存までを説明してください。
まだ生成は実行しないでください。
変更案がある場合は、対象ノードと変える値を先に示してください。説明が実際の配線と合っているか見た後で、プロンプトなど一つの値を変更します。モデル交換、ノード追加、画像生成を同時に頼むと、失敗したときに原因を絞れません。会話の利用と生成処理には、それぞれ利用条件や費用が関わるため、実行前の確認を分けます。
起動しないときは、Agentなしの状態と比較する
--enable-agentが認識されない場合は、ComfyUI本体の対応を確認します。パッケージだけを繰り返し入れ直しても、本体側の起動引数には対応できません。importに失敗する場合は、エラーに出たPythonのパスと導入先を照合します。
問題が出たらログを保存し、まずAgentの起動引数を外して従来の構成を起動します。これで動けば、Agentの有効化に関わる差分へ調査を絞れます。ただし、引数を外すだけでは変更された依存パッケージは戻りません。必要なときは、導入前の記録や復元手順を使います。
普段使う制作環境へ移す判断は、ボタンが表示されたかだけではなく、既存ワークフローの読み込み、変更、実行、保存まで確認してから行います。
配布条件と最新の導入方法はComfy Orgのcomfy-agent配布ページで確認できます。