Comfy-Org/ComfyUI_frontend
Official front-end implementation of ComfyUI
ComfyUI_frontend – ComfyUI 用の公式ウェブベースUI
ComfyUIは、AI画像生成パイプライン（Stable Diffusion、ControlNetなど）を構築・実行するためのオープンソースのビジュアルプログラミング環境です。ComfyUI_frontend は、ブラウザ（またはElectronベースのデスクトップアプリ）で動作するコンパニオン・フロントエンドであり、コードを書くことなくパイプラインを組み立て、編集、実行することを可能にします。
何ができるか
- グラフエディタ – 各ノードがAIモデル、前処理ステップ、または後処理操作を表す、ノードベースのキャンバス（Litegraph上に構築）です。ユーザーはノードをドラッグ＆ドロップ、接続、および視覚的に設定できます。
- リアルタイムプレビュー – グラフの実行中に生成された画像が即座に表示されるため、実験が迅速に行えます。
- 組み込みツール – マスクエディタ、キュー/履歴サイドバー、曖昧検索機能付きノードライブラリ、およびカスタマイズ可能なトップバー。
- 国際化 – UIから選択可能な14言語のネイティブi18nサポート。
- 拡張性 – JavaScript拡張APIにより、開発者はコアコードを変更することなく、カスタムパネル、コマンド、キーバインド、トースト通知、および設定を追加できます。
主な機能（最新リリース時点）
| 機能 | 内容 |
|---|---|
| ネイティブ翻訳 (v1.5) | Comfy > Locale > Language から言語を選択できます。UI文字列は即座に翻訳され、サードパーティ製プラグインは不要です。 |
| マスクエディタ (v1.4) | UI内で直接マスクをペイントまたはインポートし、ノードにアタッチできます。 |
| 統合サーバーターミナル (v1.3.22) | Ctrl+` を押して、ComfyUIバックエンドと通信するターミナルを開きます。 |
| キーバインドのカスタマイズ (v1.3.7) | 専用のUIを介して、ショートカットの再マッピング、ノードタイトルの編集、キャンバスのリセットなどが行えます。 |
| ノードライブラリ・サイドバー (v1.2.4) | ノードをドラッグ＆ドロップ、タイプ別にフィルタリング、および曖昧一致による検索が可能です。 |
| キュー/履歴サイドバー (v1.2.0) | 過去の実行結果を確認、再実行、または中間結果を調査できます。 |
| LitegraphのQoL向上機能 – ネストされたグループ、グループ選択、リンクの可視性切り替え、自動ウィジェットから入力への変換、パンモード、Shift+ドラッグによるリンク作成、オプション入力の「ドーナツ」など。 |
拡張API (クイック・チートシート)
// Register an extension
app.registerExtension({
name: 'MyExtension',
// add a custom sidebar tab
sidebarTabs: [{
id: 'myTab',
title: 'My Tab',
icon: 'pi pi-star',
render: el => { el.innerHTML = '<div>Hello</div>'; }
}],
// add a top‑bar menu command
commands: [{ id: 'myCmd', label: 'Do it', function: () => alert('run') }],
menuCommands: [{ path: ['ext', 'my'], commands: ['myCmd'] }],
// custom keybinding
keybindings: [{ combo: { key: 'k' }, commandId: 'myCmd' }],
// toast notification
onLoad: () => app.extensionManager.toast.add({ severity: 'info', summary: 'Loaded', detail: 'MyExtension ready' })
});
The APIはまた、window.prompt/confirm/alert の代替（Electronデスクトップ版では利用不可）および、モダンな設定システム (app.registerExtension({ settings: [...] })) を提供します。
リリース・サイクル
- 開発フェーズ –
developmentブランチでの2週間の機能開発。 - 機能凍結 (Feature freeze) – 2週間、リリースブランチへのバグ修正のみがチェリーピックされます。
- 公開 – 凍結期間の終了時に、安定版がタグ付けされます。
- ナイトリービルド – 毎日公開されます。
--front-end-version Comfy-Org/ComfyUI_frontend@latestを使用してComfyUIを起動することで利用可能です。
サイクルが重なっているため、前のバージョンが凍結期間中である間に、新しいマイナーバージョンが開発開始されることになり、マージから安定版リリースまでの期間はおよそ4週間となります。
はじめに / トラブルシューティング
- インストール – フロントエンドはComfyUIデスクトップアプリに同梱されています。または、ウェブのみのセットアップ用に個別に提供されます。公式ドキュメントに従ってください: https://docs.comfy.org/installation/desktop/windows.
- 共通のトラブル – パフォーマンスのヒント、カスタムノードの競合、デスクトップ版特有の挙動については、トラブルシューティングガイドを参照してください: https://docs.comfy.org/troubleshooting/overview.
- 開発 – 開発環境のセットアップ、Storybookの実行、および拡張機能の作成については、
CONTRIBUTING.mdを参照してください。
どのような人が使うのか？
アーティスト & クリエイター – ビジュアル・ワークフローを好好む、Stable Diffusionパイプラインを構築する人々。
研究者 – Pythonのグルーコードを書くことなく、新しいモデルの組み合わせをプロトタイプ化する人々。
拡張機能開発者 – ComfyUIにカスタムUIパネル、コマンド、または統合機能を追加したい開発者。
結論
ComfyUI_frontend は、ComfyUI AIワークフロー・エンジン用の、多機能で積極的にメンテナンスされているUIレイヤーです。洗練練されたノードグラフ・エディタ、多言語対応、および豊富なJavaScript拡張システムを提供し、すべてはナイトリービルドによる早期アダプター向けの提供を含む、予測可能なスケジュールでリリースされます。
関連
- プロジェクト
- プロジェクト
- プロジェクト
- プロジェクト
- プロジェクト