From 5b89e04f5a7b39f2505bc55fdaad6d160e7772aa Mon Sep 17 00:00:00 2001 From: zeeoale <35302039+zeeoale@users.noreply.github.com> Date: Tue, 20 Jan 2026 02:23:55 +0100 Subject: [PATCH] Update README with Identity Mixer and usage details Enhanced README with additional features and clearer instructions. --- README.md | 172 +++++++++++++++++++++++++----------------------------- 1 file changed, 78 insertions(+), 94 deletions(-) diff --git a/README.md b/README.md index 70638df..c8eedc4 100644 --- a/README.md +++ b/README.md @@ -1,35 +1,45 @@ # traumakom Prompt Generator โ€“ ComfyUI Node -A powerful custom node for ComfyUI that generates rich, dynamic prompts based on modular JSON worlds โ€” with color realm control (RGB / CMYK), LoRA triggers, and optional AI-based prompt enhancement. +A powerful custom node for ComfyUI that generates rich, dynamic prompts based on modular JSON worlds โ€” with color realm control (RGB / CMYK), LoRA triggers, optional AI-based prompt enhancement, and a modular **Identity Mixer** to build consistent characters from reusable traits. -> Created with passion by [traumakom](https://github.com/traumakom) +> Created with passion by traumakom > Powered by Dante ๐Ÿˆโ€โฌ›, Helly ๐Ÿบ, and Lily ๐Ÿ’ป ---- - -image +Screenshot_20260120_021750 +Screenshot_20260120_021811 +image ## ๐ŸŒŸ Features -- ๐Ÿ”ฎ Dynamic prompt generation from modular JSON worlds -- ๐ŸŽจ `COLOR_REALM` support for RGB / CMYK palette-driven aesthetics -- ๐Ÿง  Optional AI enhancer using OpenAI, Cohere, or Gemini -- ๐Ÿงฉ LoRA trigger integration (e.g., `Realistic`, `Detailed Hand`) +### PromptCreator Core +- ๐Ÿ”ฎ Dynamic prompt generation from modular **JSON worlds** +- ๐ŸŽจ `COLOR_REALM` support for **RGB / CMYK** palette-driven aesthetics +- ๐Ÿงฉ LoRA trigger integration (e.g., `Realistic`, `Detailed Hands`) +- ๐Ÿง  Optional AI enhancer (OpenAI / Cohere / Gemini / Ollama / llama.cpp) to rewrite or enrich prompts - ๐Ÿ“ Reads world data from `/JSON_DATA` -- ๐Ÿงช Debug messages and error handling for smooth workflow +- ๐Ÿงช Debug messages + error handling for smoother workflows +- ๐Ÿ”„ Reload JSON worlds without restarting ComfyUI + +### โœ… Identity Mixer (NEW) +- ๐Ÿงฌ Modular identity generation via reusable traits +- โ™ป๏ธ Trait library (`TRAITS`) + curated presets (`PRESETS`) +- ๐ŸŽฒ Randomized or fixed identity attributes +- ๐Ÿ“ด Optional ethnicity exclusion (`None`) +- ๐Ÿงท Identity signature output for dataset consistency +- ๐Ÿงผ Explicit trait syntax (e.g. `lavender hair`, `emerald eyes`) to avoid semantic bleed --- ## ๐Ÿ“ฆ Installation -### ๐Ÿ”ธ Option 1: Using ComfyUI Manager -1. Open ComfyUI โ†’ `Manager` tab -2. Click `Install from URL` -3. Paste the GitHub repo link and hit Install +### Using ComfyUI Manager +1. Open ComfyUI โ†’ Manager +2. Install from URL +3. Paste the GitHub repository URL -### ๐Ÿ”ธ Option 2: Manual Install +### Manual ```bash cd ComfyUI/custom_nodes git clone https://github.com/yourusername/PromptCreatorNode.git @@ -43,103 +53,77 @@ git clone https://github.com/yourusername/PromptCreatorNode.git ComfyUI/ โ”œโ”€โ”€ custom_nodes/ โ”‚ โ””โ”€โ”€ PromptCreatorNode/ -โ”‚ โ””โ”€โ”€ PromptCreatorNode.py +โ”‚ โ”œโ”€โ”€ PromptCreatorNode.py +โ”‚ โ”œโ”€โ”€ IdentityMixerNode.py โ”œโ”€โ”€ JSON_DATA/ -โ”‚ โ”œโ”€โ”€ RGB_Chronicles.json -โ”‚ โ”œโ”€โ”€ CMYK_Chronicles.json -โ”‚ โ””โ”€โ”€ ... +โ”‚ โ””โ”€โ”€ *.json +โ”œโ”€โ”€ identity.json +โ”œโ”€โ”€ identities.json โ”œโ”€โ”€ api_keys.txt ``` -> โœ… `api_keys.txt` is a **simple text file**, **not** JSON. Example: +--- +## โš™๏ธ Usage + +### PromptCreator +1. Select a JSON world +2. Enable AI enhancer (optional) +3. Generate prompt +4. Connect to CLIPTextEncode + +### Identity Mixer +1. Select traits or presets +2. Use random or fixed values +3. Output identity string + signature +4. Append to prompt or dataset captions + +--- + +## ๐ŸŒˆ identity.json Structure + +### TRAITS +Reusable identity components: +```json +{ + "TRAITS": { + "hair_color": ["lavender hair", "cobalt-blue hair"], + "eyes_color": ["emerald eyes", "icy gray eyes"], + "ethnicity": ["None", "Mediterranean", "East Asian"] + } +} ``` -openai=sk-... -cohere=... -gemini=... + +### PRESETS +Optional curated identities: +```json +{ + "PRESETS": { + "Kira_Goth": { + "hair_color": ["cobalt-blue hair"], + "expression_base": ["quiet intensity"], + "ethnicity": ["None"] + } + } +} ``` --- -## โš™๏ธ How to Use +## ๐Ÿงช AI Enhancement -1. Open ComfyUI and search for the **PromptCreator** node -2. Choose one of the installed JSON worlds from the dropdown (e.g. `RGB_Chronicles`) -3. Optionally enable AI Enhancement (OpenAI / Cohere / Gemini) -4. Click **Generate Prompt** -5. Connect the output to `CLIPTextEncode` or use however you'd like! +Supports OpenAI, Cohere, and Gemini. +API keys must be placed in `api_keys.txt`. --- -## ๐Ÿงช Prompt Enhancement +## โ˜• Support -When selected, the enhancer will transform your raw prompt into a refined, vivid description using: - -- **OpenAI** (GPT-3.5-turbo) -- **Cohere** (Command R+) -- **Gemini** (Gemini 2.5 Pro) - -> Make sure to place the correct API key in `api_keys.txt`. - ---- - -## ๐ŸŒˆ JSON World Format - -Each `.json` file includes categories like: - -- `COLOR_REALM`: Defines the active color palette (e.g. ["C", "M", "Y", "K"]) -- Realm-specific values: `OUTFITS`, `LIGHTING`, `BACKGROUNDS`, `OBJECTS`, `ACCESSORIES`, `ATMOSPHERES` -- Global traits: `EPOCHS`, `POSES`, `EXPRESSIONS`, `CAMERA_ANGLES`, `HORROR_INTENSITY` - -JSON files must be saved inside the `ComfyUI/JSON_DATA/` folder. - ---- - -## ๐Ÿ–ผ๏ธ Example Output - -Generated using the CMYK Realm: - -> โ€œA beautiful woman wearing a shadow-ink kimono, standing in a forgotten monochrome realm, surrounded by voidstorm pressure and carrying an inkborn scythe.โ€ - ---- - -## And Remember: - -๐ŸŽ‰ Welcome to the brand-new **Prompt JSON Creator Hub**! -A curated space designed to explore, share, and download structured JSON presets โ€” fully compatible with your Prompt Creator app. - -๐Ÿ‘‰ **Visit now**: [https://json.traumakom.online/](https://json.traumakom.online/) - -### โœจ What you can do: -- Browse all available public JSON presets -- View detailed descriptions, tags, and contents -- Instantly download and use presets in your local app -- See how many JSONs are currently live on the Hub - -The Prompt JSON Hub is constantly updated with new thematic presets: portraits, horror, fantasy worlds, superheroes, kawaii styles, and more. - -> ๐Ÿ”„ After adding or editing files in your local `JSON_DATA` folder, use the ๐Ÿ”„ button in the Prompt Creator to reload them dynamically! - - -## โ˜• Support My Work - -If you enjoy this project, consider buying me a coffee on Ko-Fi: -[https://ko-fi.com/traumakom](https://ko-fi.com/traumakom) - - -## ๐Ÿ™ Credits - -Thanks to: - -- **Magnificent Lily** ๐Ÿ’ป -- **My wonderful cat Dante** ๐Ÿ˜ฝ -- **My one and only muse Helly** ๐Ÿ˜โค๏ธโค๏ธโค๏ธ๐Ÿ˜ +If you enjoy this project, consider supporting it on Ko-Fi. --- ## ๐Ÿ“œ License Free to use and remix. -If you love it, โญ star the repo or โ˜• donate a coffee! - -Let the prompt alchemy begin ๐Ÿงชโœจ +Star the repo if you like it โญ