1.14

Author: phamhungd

README.md

@@ -29,18 +29,34 @@ ___
 [**Example**](#Example)
 
 ___
-# Todo
+# Overview
+
+- A full toolkit of smart ComfyUI nodes covering loading/downloading, merging, masks, layouts, and API-based generation for SD15, SDXL, Flux, and more.
+- Built-in conveniences: auto model-type detection (CFG/sampler/scheduler), translation + dynamic prompt support across text fields, ControlNet/Apply Style presets, and curated model/style libraries (`model_lib*.json`, `lora_lib.json`, `styles.csv`).
+- Download helpers for checkpoints, LoRA, ControlNet, upscalers, IPAdapter/InstantID, and image sources (Pinterest/URL/Instagram) with aria2c acceleration when available.
+- Utilities for metadata inspection/editing, streamlined wiring (Pipe/Switch/Any nodes), mask tools, and API nodes for Gemini, OpenAI, Hugging Face, and Deepseek.
+- Workflow examples live in the `examples` folder; preview images are in `preview` to quickly show what each node set does.
 
+# Todo
 - [x] Workflow Example
 - [x] Guide
 - [x] Install
 ___
 
+# Quick start
+
+- Clone into `custom_nodes`, then install Python deps from the ComfyUI root: `pip install -r custom_nodes/SDVN_Comfy_node/requirements.txt`
+- macOS/Windows: install `aria2c` manually for download nodes.
+- (Optional) Rename `API_key.json.example` to `API_key.json` and fill in keys; copy `my_styles.csv.example` to `my_styles.csv` to customize style presets.
+- Start ComfyUI — nodes appear under SDVN categories; recommended companion nodes are listed below.
+___
+
 # Install
 
 Install with simple commands: 
 - `cd <ComfyUI folder path>/custom_nodes`
 - `git clone https://github.com/StableDiffusionVN/SDVN_Comfy_node`
+- From your ComfyUI root, install dependencies: `pip install -r custom_nodes/SDVN_Comfy_node/requirements.txt`
 - *For Windows or macOS machines, users are required to manually install `aria2c` in order to use nodes that automatically download models.*
 
 Also you should install the following nodes to be able to use all functions:
@@ -102,6 +118,7 @@ This is a powerful node that combines 5 different loading modes (Input Folder, C
 - Support Random ability with Dynamic Prompt (Request installed node [Dynamicprompts](https://github.com/adieyal/comfyui-dynamicprompts))
 - Support Translate function
 - Support Style Card.
+- Includes helper text encoders for advanced models: **Qwen Edit Text Encoder / Plus** and **Kontext Reference** (pass reference images/masks into conditioning/latent).
 
 **🗂️ Prompt Styles**
 
@@ -116,6 +133,7 @@ Provide full option to use ControlNet in a single node (Request installed node [
 - Supports automatic downloading of most popular ControlNet models for SD15, SDXL, and Flux.
 - Supports direct usage with ControlNet Inpaint Alimama Flux.
 - Supports exporting parameters for integration with the AutoGenerate node.
+- Extras: **Diffsynth Controlnet Apply** and **Diffsynth Union Lora Apply** for users who work with Diffusynth workflows.
 
 **🌈 Apply Style Model**
 
@@ -213,6 +231,14 @@ A node that intelligently arranges image layouts with various flexible modes, he
 **🧅 Overlay Two Images | 🎭 Mask → Transparent Color | 🧩 Overlay Mask Color on Image**
 
 - Blend images and visualize masks with custom colors.
+
+**🖼️ Save Image Compare**
+
+- Save before/after pairs side-by-side for quick QA within a workflow.
+
+**🖼️ Image Gallery**
+
+- Browse, paginate, and download/collect images (local or remote/pinterest/URL) into a gallery with temp caching.
 ___
 
 ### Download
@@ -221,6 +247,7 @@ ___
 -  Supports direct download from **civitai** and **huggingface** with model address link and model download link
 -  Additionally, some nodes provide a list of popular models to make downloading them more convenient and faster.
 -  Includes download nodes for IPAdapter, InstantID, DualCLIP, QuadrupleCLIP and more.
+-  Extra download helpers: **AnyDownload List**, **ModelPatch/UNET/CLIP/Style/CLIP Vision downloads**, upscale model download, and VAE download.
 
 ![Download Nodes](/preview/download_node.png)
 
@@ -251,6 +278,7 @@ Support 3 types of syntax to adjust for each block
 **🧬 Model Merge**
 
 - This node supports merging 2 or 3 checkpoints, extracting LoRA from 2 checkpoints — similar to the merge function in Automatic1111.
+- **Model Export** saves merged results to disk with optional metadata edits.
 
 [*See more workflow examples*](#Example)
 
@@ -346,8 +374,18 @@ Example: A workflow to filter images with a width ≥ 1000px.
 - Nodes that support creating automated options and dynamically changing variables based on input.
 
 ![](preview/dic_convert.jpeg)
+
+**🎲 Random Prompt | 📋 Menu Option Extra | 🎚️ Sliders (x4)**
+
+- Quick prompt randomizer plus helper widgets (extra menu option, slider100, slider1, custom int/float slider) to speed up UI prototyping.
 ___
 
+### Dev
+
+- **Run Python Code**: inline execution of custom Python functions inside a workflow (supports dict/list unpacking).
+- **Kontext Reference / Qwen Edit Text Encoder (+ Plus)**: advanced conditioning/text encoders for reference-driven or Qwen-edit models.
+- **Save Image Compare + Image Gallery** also double as utility nodes for debugging and dataset management.
+
 ### API
 
 Support the use of AI models through API
@@ -368,12 +406,10 @@ Support the use of AI models through API
 ![](preview/chatbot2.jpeg)
 ![](preview/chatbot3.jpeg)
 
-**🎨 DALL-E 2 | 🎨 DALL-E 3 | 🎨 GPT Image**
+**🎨 DALL-E 3 | 🎨 GPT Image**
 
 - Support translate and Dynamic prompt
 
-![](preview/dalle-2.jpeg)
-![](preview/dalle-2_mask.jpeg)
 ![](preview/dalle-3.jpeg)
 ![](preview/gptimage.jpeg)
 ![](preview/gptimage_input.jpeg)
@@ -389,13 +425,12 @@ Support the use of AI models through API
 ![](preview/gemini_multi.jpeg)
 ![](preview/imagen.jpeg)
 
-**✨ IC-Light v2 | ✨ Joy Caption**
+**🎨 Gemini 3 Pro Image**
 
-A node that uses the Hugging Face API to directly interact with corresponding Spaces.
- - IC-Light v2: https://huggingface.co/spaces/lllyasviel/iclight-v2
- - Joy Caption: https://huggingface.co/spaces/fancyfeast/joy-caption-alpha-two
+- Uses Gemini 3 Pro Image Preview to return both an image and accompanying text
+- Accepts up to 14 reference images; supports aspect ratio and resolution presets
+- Translate + Dynamic prompt support, pulls API from `API_key.json` if not provided
 
-![](preview/iclight-v2.jpeg)
 ___
 
 # Info check
@@ -468,6 +503,10 @@ Nodes that support both basic and advanced mask processing and inpainting.
 
 - This node separates distinct masked areas into individual masks, working exceptionally well with the inpaint crop node set.
 
+**📏 Get Mask Size**
+
+- Returns mask width/height (and latent) to drive dimension-aware workflows.
+
 **⚡️ Crop Inpaint | 🔄 Loop Inpaint Stitch**
 
 - These 2 nodes are built based on the (https://github.com/lquesada/ComfyUI-Inpaint-CropAndStitch) node set, and you need to install that set first in order to use them.
@@ -497,4 +536,4 @@ ___
 - [fluxai.vn](https://colab.research.google.com/github/StableDiffusionVN/SDVN-WebUI/blob/main/SDVN_ComfyUI_Flux_v3.ipynb)
 
 **Course**
-- [hungdiffusion.com](https://hungdiffusion.com/)
+- [hungdiffusion.com](https://hungdiffusion.com/)

README_vi.md

@@ -27,18 +27,35 @@ ___
 [**Example**](#Example)
 
 ___
+# Tổng quan
+
+- Bộ toolkit node thông minh cho ComfyUI, bao phủ tải/tải về, merge, mask, layout và sinh ảnh qua API cho SD15, SDXL, Flux...
+- Tích hợp sẵn tiện ích: tự nhận diện loại model (CFG/sampler/scheduler), hỗ trợ dịch + dynamic prompt trên ô văn bản, preset ControlNet/Apply Style, và thư viện model/style có sẵn (`model_lib*.json`, `lora_lib.json`, `styles.csv`).
+- Hỗ trợ tải checkpoint, LoRA, ControlNet, upscale, IPAdapter/InstantID và nguồn ảnh (Pinterest/URL/Instagram) với gia tốc aria2c khi có.
+- Cung cấp tiện ích đọc/chỉnh metadata, sắp xếp dây nối gọn (Pipe/Switch/Any), công cụ mask, và node API cho Gemini, OpenAI, Hugging Face, Deepseek.
+- Thư mục `examples` chứa workflow mẫu; thư mục `preview` giúp xem nhanh giao diện/tác dụng mỗi nhóm node.
+
 # Todo
 
 - [x] Workflow Example
 - [x] Guide
 - [x] Install
 ___
 
+# Bắt đầu nhanh
+
+- Clone vào `custom_nodes`, sau đó cài phụ thuộc Python từ thư mục gốc ComfyUI: `pip install -r custom_nodes/SDVN_Comfy_node/requirements.txt`
+- macOS/Windows: tự cài `aria2c` để dùng các node tải model.
+- (Tùy chọn) Đổi `API_key.json.example` thành `API_key.json` và điền key; sao chép `my_styles.csv.example` thành `my_styles.csv` để tùy chỉnh style.
+- Khởi động ComfyUI — các node sẽ xuất hiện dưới nhóm SDVN; danh sách node nên cài thêm nằm ngay dưới đây.
+___
+
 # Install
 
 Cài đặt với các lệnh đơn giản: 
 - `cd <đường_dẫn_đến_thư_mục_ComfyUI>/custom_nodes`
 - `git clone https://github.com/StableDiffusionVN/SDVN_Comfy_node`
+- Từ thư mục gốc ComfyUI, cài phụ thuộc: `pip install -r custom_nodes/SDVN_Comfy_node/requirements.txt`
 - *Đối với máy Windows hoặc macOS, người dùng cần tự cài đặt `aria2c` để sử dụng các node tự động tải model.*
 
 Bạn cũng nên cài đặt các node sau để có thể sử dụng đầy đủ các chức năng:
@@ -99,6 +116,7 @@ Tự động tìm kiếm và tải ảnh từ Pinterest. Ảnh sẽ được t
 - Hỗ trợ khả năng Random với Dynamic Prompt (Yêu cầu cài đặt node [Dynamicprompts](https://github.com/adieyal/comfyui-dynamicprompts))
 - Hỗ trợ chức năng dịch
 - Hỗ trợ Style Card.
+- Bổ sung encoder nâng cao cho model đặc thù: **Qwen Edit Text Encoder / Plus** và **Kontext Reference** (đưa ảnh/mask tham chiếu vào conditioning/latent).
 
 **🗂️ Prompt Styles**
 
@@ -113,6 +131,7 @@ Node tổng hợp đầy đủ các tùy chọn để sử dụng ControlNet tro
 - Hỗ trợ tự động tải các model ControlNet phổ biến cho SD15, SDXL và Flux.
 - Hỗ trợ sử dụng trực tiếp với ControlNet Inpaint Alimama Flux.
 - Hỗ trợ xuất tham số để tích hợp với node AutoGenerate.
+- Bản mở rộng: **Diffsynth Controlnet Apply** và **Diffsynth Union Lora Apply** cho người dùng workflow Diffusynth.
 
 **🌈 Apply Style Model**
 
@@ -209,6 +228,14 @@ Node sắp xếp layout ảnh thông minh với nhiều chế độ linh hoạt,
 **🧅 Overlay Two Images | 🎭 Mask → Transparent Color | 🧩 Overlay Mask Color on Image**
 
 - Chồng ảnh và hiển thị mask với màu tùy chọn.
+
+**🖼️ Save Image Compare**
+
+- Lưu cặp ảnh trước/sau đặt cạnh nhau để so sánh nhanh trong workflow.
+
+**🖼️ Image Gallery**
+
+- Duyệt, phân trang và tải/thu thập ảnh (local hoặc URL/Pinterest) vào thư viện tạm.
 ___
 
 ### Download
@@ -217,6 +244,7 @@ ___
 -  Hỗ trợ tải trực tiếp từ **civitai** và **huggingface** bằng địa chỉ model hoặc link tải model
 -  Ngoài ra, một số node cung cấp danh sách các model phổ biến để tải nhanh và tiện lợi hơn.
 -  Bổ sung các node tải IPAdapter, InstantID, DualCLIP, QuadrupleCLIP và nhiều loại model khác.
+-  Các tiện ích tải thêm: **AnyDownload List**, tải ModelPatch/UNET/CLIP/Style/CLIP Vision, tải model upscale và VAE.
 ![Download Nodes](/preview/download_node.png)
 
 ___
@@ -246,6 +274,7 @@ Hỗ trợ 3 kiểu cú pháp để điều chỉnh từng block
 **🧬 Model Merge**
 
 - Node này hỗ trợ trộn 2 hoặc 3 checkpoint, tách LoRA từ 2 checkpoint — tương tự chức năng merge của Automatic1111.
+- **Model Export**: lưu kết quả merge ra file và có thể chỉnh metadata.
 
 [*Xem thêm ví dụ workflow*](#Example)
 
@@ -341,8 +370,18 @@ Ví dụ: Workflow lọc ảnh có chiều rộng ≥ 1000px.
 - Node hỗ trợ tạo tùy chọn tự động và thay đổi biến động theo đầu vào.
 
 ![](preview/dic_convert.jpeg)
+
+**🎲 Random Prompt | 📋 Menu Option Extra | 🎚️ Sliders (x4)**
+
+- Trộn prompt ngẫu nhiên và các widget phụ (menu option extra, slider100, slider1, int/float slider custom) giúp dựng UI nhanh hơn.
 ___
 
+### Dev
+
+- **Run Python Code**: chạy hàm Python tự viết trực tiếp trong workflow (hỗ trợ unpack dict/list).
+- **Kontext Reference / Qwen Edit Text Encoder (+ Plus)**: encoder conditioning/văn bản nâng cao cho các model tham chiếu hoặc Qwen edit.
+- **Save Image Compare + Image Gallery** cũng hữu ích cho debug và quản lý bộ ảnh.
+
 ### API
 
 Hỗ trợ sử dụng các model AI qua API
@@ -363,12 +402,10 @@ Hỗ trợ sử dụng các model AI qua API
 ![](preview/chatbot2.jpeg)
 ![](preview/chatbot3.jpeg)
 
-**🎨 DALL-E 2 | 🎨 DALL-E 3 | 🎨 GPT Image**
+**🎨 DALL-E 3 | 🎨 GPT Image**
 
 - Hỗ trợ dịch và Dynamic prompt
 
-![](preview/dalle-2.jpeg)
-![](preview/dalle-2_mask.jpeg)
 ![](preview/dalle-3.jpeg)
 ![](preview/gptimage.jpeg)
 ![](preview/gptimage_input.jpeg)
@@ -384,13 +421,12 @@ Hỗ trợ sử dụng các model AI qua API
 ![](preview/gemini_multi.jpeg)
 ![](preview/imagen.jpeg)
 
-**✨ IC-Light v2 | ✨ Joy Caption**
+**🎨 Gemini 3 Pro Image**
 
-Node sử dụng API Hugging Face để tương tác trực tiếp với các Spaces tương ứng.
- - IC-Light v2: https://huggingface.co/spaces/lllyasviel/iclight-v2
- - Joy Caption: https://huggingface.co/spaces/fancyfeast/joy-caption-alpha-two
+- Sử dụng Gemini 3 Pro Image Preview, trả về cả ảnh và phần văn bản kèm theo
+- Hỗ trợ tối đa 14 ảnh tham chiếu; có sẵn preset tỷ lệ khung hình và độ phân giải
+- Hỗ trợ dịch + Dynamic prompt, tự lấy API trong `API_key.json` nếu để trống
 
-![](preview/iclight-v2.jpeg)
 ___
 
 # Info check
@@ -463,6 +499,10 @@ Bộ node hỗ trợ xử lý mask cơ bản và nâng cao, cũng như inpaintin
 
 - Node này tách các vùng mask riêng biệt thành các mask riêng, hoạt động rất tốt với bộ node inpaint crop.
 
+**📏 Get Mask Size**
+
+- Trả về chiều rộng/chiều cao (và latent) của mask để xây dựng workflow phụ thuộc kích thước.
+
 **⚡️ Crop Inpaint | 🔄 Loop Inpaint Stitch**
 
 - Hai node này được xây dựng dựa trên bộ node (https://github.com/lquesada/ComfyUI-Inpaint-CropAndStitch), bạn cần cài đặt bộ node này trước khi sử dụng.
@@ -492,4 +532,4 @@ ___
 - [fluxai.vn](https://colab.research.google.com/github/StableDiffusionVN/SDVN-WebUI/blob/main/SDVN_ComfyUI_Flux_v3.ipynb)
 
 **Course**
-- [hungdiffusion.com](https://hungdiffusion.com/)
+- [hungdiffusion.com](https://hungdiffusion.com/)