https://github.com/HappyOnigiri/ComfyUI-Meld
An integrated Image Manager & Node Pack for ComfyUI. Features: Gallery, Metadata Search, Lineage Tracking, and Auto-Tagging.
https://github.com/HappyOnigiri/ComfyUI-Meld
comfyui comfyui-custom-node comfyui-extension
Last synced: 4 months ago
JSON representation
An integrated Image Manager & Node Pack for ComfyUI. Features: Gallery, Metadata Search, Lineage Tracking, and Auto-Tagging.
- Host: GitHub
- URL: https://github.com/HappyOnigiri/ComfyUI-Meld
- Owner: HappyOnigiri
- License: apache-2.0
- Created: 2026-01-23T05:32:06.000Z (5 months ago)
- Default Branch: main
- Last Pushed: 2026-02-28T13:43:56.000Z (4 months ago)
- Last Synced: 2026-02-28T15:46:26.736Z (4 months ago)
- Topics: comfyui, comfyui-custom-node, comfyui-extension
- Language: TypeScript
- Homepage:
- Size: 4.93 MB
- Stars: 1
- Watchers: 0
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.ja.md
- License: LICENSE
Awesome Lists containing this project
- awesome-comfyui - **ComfyUI-Meld**
README
# ComfyUI-Meld
[](https://opensource.org/licenses/Apache-2.0)
[](https://registry.comfy.org/)
[English README](README.md)
**生成画像を“強力なアセットデータベース”へ。**
`ComfyUI-Meld` は、混沌としがちなワークフローを整理し、生成結果を「再利用できる資産」として蓄積するためのノードパックです。プロンプト、設定、系統情報（Lineage）を自動で記録し、すべての生成履歴を保持します。
Meld Image Manager により、ComfyUI 内で検索・タグ付け・系統追跡を一体化。ベストな結果を見つけ、その“由来”を確認し、そのまま即座に次のイテレーションへつなげます。
---
## Image Manager（Meld Image Manager）
Image Manager は、ComfyUI のサイドバーに追加される統合画像管理システムです。生成画像の閲覧・検索・整理を高速化し、過去の作品をワークフローに再利用する流れをスムーズにします。
- **ギャラリー**: 生成画像を高速に一覧・整理
- **詳細ビューアー**: プロンプト、モデル、生成設定、ノート、タグの確認・編集
- **高度な検索**: プロンプト/タグ/日付/モデル名などで柔軟に絞り込み
- **系統管理（Lineage）**: img2img 等の親子関係を可視化
- **ワークフロー連携**: 画像をワンクリックで読み込み、設定やワークフローの復元を補助
基本は、ワークフロー実行完了時に **Output 画像が自動登録** されます。さらに [Meld Save Image](./docs/ja/nodes/MeldSaveImage.md) を使うと、タグの自動付与や親画像（Source）の明示指定など、管理を強化できます。
詳細な使い方とショートカット、検索構文は [`docs/ja/ImageManager.md`](./docs/ja/ImageManager.md) を参照してください。
---
## 収録ノード（全10種）
各ノードの詳細は `docs/ja/nodes/` を参照してください。
| ノード | 役割（概要） |
| :--- | :--- |
| **[Meld Prompt Constructor](./docs/ja/nodes/MeldPromptConstructor.md)** | テキストファイル群から動的構文を使ってプロンプトを構築し、ネガティブを自動分離 |
| **[Meld Auto Exposure](./docs/ja/nodes/MeldAutoExposure.md)** | 輝度を解析し、目標明るさへ近づけるガンマ補正を自動適用 |
| **[Meld Save Image](./docs/ja/nodes/MeldSaveImage.md)** | 画像保存＋Image Manager へ自動登録（メタデータ保存、pHash による Lineage 構築、タグ付け） |
| **[Meld Unified Loader](./docs/ja/nodes/MeldUnifiedLoader.md)** | Checkpoint ロードと基本生成パラメータ定義を統合し、`base_settings` として再利用可能に出力 |
| **[Meld Unified Flux Loader](./docs/ja/nodes/MeldUnifiedFluxLoader.md)** | Flux向けの統合ローダー（Guidance入力と固定CFGに対応） |
| **[Meld Settings Unpacker](./docs/ja/nodes/MeldSettingsUnpacker.md)** | `BASE_SETTINGS` 辞書を seed/steps/cfg/解像度等の個別パラメータへ分解して出力 |
| **[Meld Image Loader](./docs/ja/nodes/MeldImageLoader.md)** | 画像を読み込み、埋め込みメタデータからプロンプト/設定を抽出し、モデルロードも試行 |
| **[Meld Image Loader Batch](./docs/ja/nodes/MeldImageLoaderBatch.md)** | ディレクトリ内の画像を index 指定で連続読み込み（メタデータ解析・復元も実施） |
| **[Meld Instant Pixelate](./docs/ja/nodes/MeldPixelate.md)** | ダウンサンプル→最近傍アップスケールでピクセル化（モザイク/ドット絵） |
| **[Meld Infinite Heart Generator](./docs/ja/nodes/MeldPatternHeart.md)** | ハートパターンをグリッド/エッジ沿い等で自動配置して装飾 |
---
## インストール方法
### 推奨：ComfyUI Manager または Registry
ComfyUI Managerの検索画面から **「Meld」** と入力し、インストールしてください。
または、CLI（コマンドライン）より以下のコマンドを実行します。
```bash
comfy node install HappyOnigiri/ComfyUI-Meld
```
### 手動インストール
`custom_nodes` ディレクトリで以下のコマンドを実行し、ComfyUIを再起動してください。
```bash
git clone https://github.com/HappyOnigiri/ComfyUI-Meld.git
cd ComfyUI-Meld
pip install -r requirements.txt
make setup-hooks # Git フックの有効化 (推奨)
```
---
## 仕様と要件
* **対応OS**: Windows / Linux / macOS
* **Python**: 3.10以上推奨
* **ライセンス**: Apache License 2.0 (商用利用可、改変可)
---
## プライバシー
画像メタデータから **生成に関する情報（プロンプト/ワークフロー等）のみ** を抽出し、GPS 等のプライベートな EXIF データは読み込みません。また、ファイル読み込みは **指定したディレクトリとそのサブディレクトリ** のみに限定します（適切なアクセス権限管理を推奨します）。
---
## サポート・フィードバック
不具合の報告や新機能の要望、使い方が分からない場合の質問など、あらゆるフィードバックを歓迎しています！
開発者への連絡やフィードバックは、GitHub Issues から気軽に送ってください。
* **不具合報告 (Bug Report)**: エラーログやスクリーンショットを添付していただけると、修正がスムーズになります。
* **機能要望 (Feature Request)**: 「こんな機能が欲しい」「ここが使いにくい」といったアイデアをお待ちしています。
> **Notice:** 開発者は日本人ですので、Issue は日本語で気軽にどうぞ。
[GitHub Issues を開く](https://github.com/HappyOnigiri/ComfyUI-Meld/issues)
---
## 貢献について (Contribution)
**Pull Request (PR) は、ドキュメントの誤字修正から新機能の実装まで、どんな小さなものでも大歓迎です！**
このリポジトリでは `main` ブランチへの直接コミットを禁止しています。開発の際は、新しいブランチを作成して PR を作成してください（`make setup-hooks` を実行すると、自動チェックが有効になります）。
完璧なコードである必要はありません。「とりあえず動く」状態でも問題ありません。
---
**開発元**: [HappyOnigiri](https://github.com/HappyOnigiri)
---