From ec41c81661ebf19e4bbcc654f5c328aee4c4642c Mon Sep 17 00:00:00 2001
From: vekitan55 <140900198+vekitan55@users.noreply.github.com>
Date: Wed, 23 Apr 2025 20:43:35 +0900
Subject: [PATCH] Update README.md

---
 README.md | 74 ++++++++++++++++++++++++++++++++++++++++++++-----------
 1 file changed, 60 insertions(+), 14 deletions(-)

diff --git a/README.md b/README.md
index b1d6ce4..30bae63 100644
--- a/README.md
+++ b/README.md
@@ -1,23 +1,69 @@
-# Simplified Flux.1 Merge for ComfyUI
+# Simple Flux.1 Merger for ComfyUI
 
-This extension provides expert-level control over Flux.1 model merging via ComfyUI.
+A custom ComfyUI node set for merging Flux.1-based models with intuitive control.  
+This extension provides **both simplified group merging** and **expert per-layer control**, including support for advanced difference-based merge modes.
 
-## Included Node
+---
 
-### ExpertFlux1Merge
+## 📦 Included Nodes
 
-- Per-layer weight control (double_blocks, single_blocks, and top-level layers)
-- Merge modes: standard, add_difference, train_difference
-- Efficient memory use with bfloat16
-- Suitable for high-precision model tuning
+### 1. **SimplifiedFlux1Merge**
+- Intuitive UI with 9 group-based sliders for merging double and single transformer blocks.
+- Preserves control over top-level layers like `img_in`, `txt_in`, `final_layer`.
+- Designed for quick and effective model blending.
 
-## Usage
+### 2. **ExpertFlux1Merge**
+- Fine-grained control for all 19 `double_blocks`, 38 `single_blocks`, and all top-level blocks (`img_in`, `txt_in`, etc.).
+- Ideal for advanced users seeking precise model tuning.
+- Includes interpolation-safe FP16/BF16 handling and memory optimization.
 
-1. Place this folder in your `ComfyUI/custom_nodes/` directory.
-2. Launch ComfyUI and add the node from the Flux.1 category.
-3. Connect three compatible models (A, B, C).
-4. Adjust sliders and choose merge mode.
+---
 
-## License
+## 🧠 Supported Merge Modes
 
+| Mode              | Description                                                                 |
+|-------------------|-----------------------------------------------------------------------------|
+| `standard`        | Linear interpolation between A and B (`A * w + B * (1-w)`)                  |
+| `add_difference`  | Adds difference between B and A to A (`A + w * (B - A)`)                     |
+| `train_difference`| Adds training diff from C to A (`A + w * (B - C)`), mimicking LoRA learning |
+
+---
+
+## 🛠 Installation
+
+Clone or download this repository into your ComfyUI `custom_nodes/` directory:
+
+```bash
+git clone https://github.com/yourname/comfyui-simplified-flux1.git
+
+## 🚀 Usage
+Launch ComfyUI.
+
+Add either:
+
+Simplified Flux.1 Merge node
+
+Expert Flux.1 Merge node
+
+Connect 3 Flux.1-compatible models to model_a, model_b, and model_c.
+
+Adjust sliders to define merge ratios.
+
+Select merge mode and execute.
+
+## 📌 Notes
+Compatible with Flux.1 and Schnell variants (if matching architecture).
+
+Requires sufficient GPU memory; optimized for BF16.
+
+train_difference mode requires model C to match A/B in structure.
+
+## 📜 License
 MIT License
+
+## 🙏 Credits
+Based on Flux.1 architecture by Black Forest Labs.
+
+Inspired by SuperMerger.
+
+Developed for ComfyUI advanced model merging workflows.