From bb012f3f66be44fe4b26e7a22de7bd29295936f9 Mon Sep 17 00:00:00 2001
From: 0velia <130620218+0velia@users.noreply.github.com>
Date: Fri, 10 Jul 2026 23:49:11 +0700
Subject: [PATCH] Add files via upload

---
 README.MD | 74 +++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 74 insertions(+)
 create mode 100644 README.MD

diff --git a/README.MD b/README.MD
new file mode 100644
index 0000000..e0ccc4d
--- /dev/null
+++ b/README.MD
@@ -0,0 +1,74 @@
+# 🎭 ComfyUI Dynamic Dropdowns & Assistant
+
+A self-contained, high-efficiency custom node system and Windows desktop companion app for ComfyUI. This tool eliminates canvas clutter by consolidating multiple text attribute dropdowns (e.g., hair lengths, colors, styles, outfits, lighting) into a single, cohesive comma-separated output block—serving it simultaneously as a raw string and an encoded conditioning prompt.
+
+---
+
+## ✨ Features
+
+* **📦 100% Self-Contained Architecture:** No messy global asset paths. The custom node scans its own local `lists/` subfolder, ensuring absolute portability. If you copy the node folder to another machine, it works instantly.
+* **🧠 Dual Prompt Injection Engine:** Outputs both a raw `STRING` (for prompt text stacking/debugging) and a pre-tokenized `CONDITIONING` block (to wire directly into KSampler slots, bypassing separate Text Encode nodes).
+* **💻 Desktop Companion Utility (`Node Builder Assistant.exe`):** A zero-dependency, hardware-accelerated Windows UI tool that lets you visually build, update, and manage your custom node structures offline without writing a single line of Python.
+* **🧼 Automatic Formatting & Cleaning:** The node backend strips out double quotes (`"`), trailing backslashes (`\`), empty rows, and handles string concatenation automatically, preventing messy trailing commas in your generation prompts.
+
+---
+
+## 📂 Repository Architecture
+
+When properly deployed, your project folder maintains this modular layout:
+
+ComfyUI-Dynamic-Dropdowns/
+├── Node Builder Assistant.exe   # Standalone node generator app
+├── __init__.py                  # The active ComfyUI custom node script
+├── README.md                    # Project documentation
+├── .gitignore                   # Dev exclusion rules
+├── lists/                       # Put your choice text assets here!
+│   ├── hair_length.txt
+│   ├── hair_color.txt
+│   └── hairstyle.txt
+└── generator/                   # Companion App source folder (for updates)
+    ├── app.py                   # PyWebView window engine wrapper
+    ├── generator.html           # Desktop interface panel
+    ├── requirements.txt         # Dev build dependencies
+    └── build.py                 # Isolated one-click .exe compiler
+
+---
+
+## ⚙️ Installation Guide
+
+### Standard User Installation
+1. Download this repository or clone it directly into your ComfyUI nodes directory:
+   git clone [https://github.com/YOUR_USERNAME/ComfyUI-Dynamic-Dropdowns.git](https://github.com/YOUR_USERNAME/ComfyUI-Dynamic-Dropdowns.git)
+2. Navigate inside the `ComfyUI-Dynamic-Dropdowns` directory and create an empty folder named `lists`.
+3. Drop your text-attribute files (e.g., `outfits.txt`, `hairstyles.txt`) inside that `lists/` folder. Ensure text files feature exactly **one choice per line**, with no blank trailing lines.
+4. Launch or restart ComfyUI.
+
+---
+
+## 🚀 How to Use
+
+### 1. Generating or Updating Nodes via the Companion App
+If you want to configure what dropdown columns display inside ComfyUI:
+1. Double-click **`Node Builder Assistant.exe`** right in the root directory.
+2. Click **+ Add Dropdown Menu** for each menu attribute slot you wish to manage.
+3. Assign the text label name (e.g., `hair_color`) and match it exactly to the `.txt` file name located inside your `lists/` folder.
+4. Click **Build Custom Node** to generate the node logic.
+5. Click **Download Code**, save the file, and name it exactly **`__init__.py`**, replacing the existing script in the root folder.
+
+### 2. Canvas Workflow Mapping
+Inside the ComfyUI grid canvas interface:
+1. Right-click anywhere and locate your node via `Custom Selection -> Universal Text Selector` (or your custom display title).
+2. Wire your primary **`CLIP`** pipeline dot from your Model Loader directly into the node's **`clip`** input dot on the left.
+3. Route your outputs on the right side:
+    * **`PROMPT_STRING`** -> Connect this to prompt text combiners, custom wildcards, or visual display text debuggers.
+    * **`CONDITIONING`** -> Route this dot directly into your **`KSampler` (positive / negative)** inputs, instantly bypassing standard text box nodes.
+
+---
+
+## 🛠️ Developer / Compilation Setup
+If you want to modify the companion app layout styles or tweak the core source generation engine:
+1. Make your code alterations inside `generator/generator.html` or `generator/app.py`.
+2. Open your command terminal inside the `/generator` folder and execute the one-click compilation automator script:
+   python build.py
+   
+This script dynamically sets up an isolated Python virtual environment, installs the compression assets, strips module bloat, compiles the new optimized binary, moves it directly to the root path as `Node Builder Assistant.exe`, and purges temporary cache files automatically.
\ No newline at end of file