Initial commit

README.md

@@ -0,0 +1,83 @@
+# AODH Pack
+
+A set of custom ComfyUI nodes designed to streamline the creation of images for anime and video game characters using structured JSON data.
+
+## Nodes
+
+### Character JSON Reader
+
+The **Character JSON Reader** node allows you to load character definitions from JSON files stored in the `characters` directory. It parses the JSON and outputs individual strings for various character attributes, making it easy to build complex prompts.
+
+#### Features:
+- **Automatic File Discovery**: Scans the `nodes/character_reader/characters/` folder for `.json` files.
+- **Selection Modes**:
+    - `manual`: Select a specific file from the dropdown.
+    - `sequential`: Cycles through files based on the `index` input.
+    - `random`: Picks a random file using the `index` as a seed.
+- **Structured Outputs**: Provides 21 distinct output pins covering identity, wardrobe, and style.
+- **Prompt-Ready Formatting**: Automatically appends a comma to every non-empty output string.
+- **Robustness**: Ensures all outputs are valid strings, even if fields are missing from the JSON.
+
+### Resolution Reader
+
+The **Resolution Reader** node reads resolution configurations from text files. Each line in the text file should follow the format: `width, height, upscale`.
+
+#### Features:
+- **Selection Modes**:
+    - `manual`: Uses the first line of the selected file.
+    - `sequential`: Cycles through lines in the file based on the `index` input.
+    - `random`: Picks a random line from the file using the `index` as a seed.
+- **Outputs**: Provides `width` (INT), `height` (INT), and `upscale` (FLOAT).
+
+#### JSON Structure:
+
+Place your character JSON files in the `nodes/character_reader/characters/` directory. The expected format is:
+
+```json
+{
+  "character_id": "unique_id",
+  "identity": {
+    "base_specs": "...",
+    "hair": "...",
+    "eyes": "...",
+    "expression": "...",
+    "hands": "...",
+    "arms": "...",
+    "torso": "...",
+    "pelvis": "...",
+    "legs": "...",
+    "feet": "...",
+    "distinguishing_marks": "..."
+  },
+  "wardrobe": {
+    "inner_layer": "...",
+    "outer_layer": "...",
+    "lower_body": "...",
+    "footwear": "...",
+    "gloves": "...",
+    "accessories": "..."
+  },
+  "styles": {
+    "aesthetic": "...",
+    "primary_color": "...",
+    "secondary_color": "...",
+    "tertiary_color": "..."
+  },
+  "lora":{
+    "lora_name": "...",
+    "lora_Weight": "...",
+    "lora_triggers": "..."
+  }
+}
+```
+
+## Installation
+
+1. Clone this repository into your `ComfyUI/custom_nodes/` directory.
+2. Add your character JSON files to the `nodes/character_reader/characters/` folder.
+3. Add your resolution text files to the `nodes/resolution_reader/resolutions/` folder.
+4. Restart ComfyUI.
+
+## Usage
+
+Find the node under the `AODH Pack` category in the ComfyUI node menu. Select your character file from the dropdown, and connect the output pins to your prompt encoding nodes.