ComfyUI WorkflowをGitで管理する|JSON差分・モデル・Node Versionの扱い
ComfyUIのworkflowをGitで管理するなら、JSON・設定・依存の台帳だけをリポジトリに入れ、model本体と生成物は外に置きます。命名とフォルダ規約、modelのURL・hash・license台帳、custom nodeのmanifest、整形で差分を読みやすくする方法、検証条件の紐づけまで解説します。
AIとつくる、実践プログラミング・コーディングメディア
ARCHIVE
ComfyUIのworkflowをGitで管理するなら、JSON・設定・依存の台帳だけをリポジトリに入れ、model本体と生成物は外に置きます。命名とフォルダ規約、modelのURL・hash・license台帳、custom nodeのmanifest、整形で差分を読みやすくする方法、検証条件の紐づけまで解説します。
ComfyUIカスタムノードのCI/CDは、純Python部分のpytest、ComfyUI環境でのImport Smoke Test、Tagと連動したReleaseの3層で組み、公開は手動承認のGateを残す形が最小です。何を自動で確かめ、何を人が判断するかを分けて解説します。
Comfy Registryに自作カスタムノードを公開する手順を解説。Publisher IDとAPIキー、comfy node initで作るpyproject.tomlの必須フィールド、comfy node publishとGitHub Actionsの2経路、SemVerでの更新、eval/exec禁止などの安全基準まで公式仕様に沿って整理します。
ComfyUIカスタムノードにJavaScriptでボタンや表示を足す方法を解説。WEB_DIRECTORYの公開、app.registerExtensionのhook、Widget値がworkflow JSONに残る仕組み、Nodes 2.0での互換確認、UI例外からBackend処理を守る設計まで扱います。
ComfyUIの知らないノードは、Node Docsで「入力・処理・出力」と「何のデータ型が流れるか」を読めば自力で理解できます。MODEL・CLIP・LATENT・IMAGEの意味、required/optional、Widgetと接続の違い、配布Workflowの読み方、Docsが無いCustom Nodeの調べ方を解説します。
更新で壊れたComfyUIは、更新前に保存したSnapshotをRestoreして再起動すれば戻せます。本体・Frontend・Manager・Custom Nodeの4層の記録、Snapshotの作成と復元、最小Workflowでの確認、差分を1つずつ戻す手順を解説します。
ComfyUI Nodes 2.0は生成モデルではなく、ノード描画をLiteGraphのCanvasからVueに置き換えたUI基盤の変更です。旧UIとの違い、ロゴメニューからの切り替えと戻し方、Custom Node互換性の確認、大型ワークフローでの比較手順、3タイプ別の導入判断をまとめます。
ComfyUIのカスタムノードは、INPUT_TYPES・RETURN_TYPES・FUNCTIONを持つPythonクラスをcustom_nodes配下に置き、NODE_CLASS_MAPPINGSで登録すれば動きます。文字列を加工する最小ノードを例に、作るべきかの判断、実装、登録、型、壊れにくくする整備まで解説します。
ComfyUIのImport Failedは本体の故障ではなく、特定のcustom nodeのPython importが失敗した状態です。起動logの「Import times for custom nodes」から対象を特定し、ModuleNotFoundErrorの読み方、Python実体の確認、nodeの一時無効化、再発防止までを順に示します。
ComfyUI Managerは現在ComfyUI本体に組み込まれ、Custom NodeはRegistryのversion単位で導入・更新します。新UIでの検索・導入・Missing Node特定・更新前確認・切り戻しの入口・安全なnodeの選び方を、2026年8月時点の名称で整理します。
IP-Adapterは参照画像をCLIP特徴量に変えてmodelに渡す「画像で書いたprompt」です。ComfyUI_IPAdapter_plusの最小接続、同じseedでweightを4段階比較する手順、ControlNet・LoRAとの役割分担、参照画像の権利確認まで整理します。