ComfyUI Extension: Wizdroid ComfyUI Outfit Selection

Authored by wizdroid

Created

Updated

0 stars

A comprehensive outfit generation system for ComfyUI with AI-powered prompt enhancement and dynamic outfit composition.

Custom Nodes (0)

    README

    Wizdroid ComfyUI Outfit Selection

    <p align="center"> <img src="icon.svg" alt="Wizdroid Outfits" width="64" height="6### Mak- **Sprite Sheets**: Game-ready character sprites

    πŸ“‹ Prerequisiteslick the Makeup field to open the animated editor

    • Add items like lipstick, eyeliner, blush, highlighter
    • Use Enable/Duplicate/Clear All controls for quick edits

    Avoid Terms

    • Use the Avoid field to list items you don't want (comma-separated or free text)
    • These are appended as "Avoid: ..." in the final prompt

    Export Preset

    • Toggle "export_preset" to print a preset JSON snippet to the console
    • Paste under your gender in data/presets.json and give it a name License: MIT Python 3.8+ ComfyUI GitHub release

    A comprehensive outfit generation system for ComfyUI with AI-powered prompt enhancement and dynamic outfit composition.

    πŸ“– Table of Contents

    🎯 Features

    πŸ‘— Dynamic Outfit Generation

    • Female & Male Outfit Nodes: Generate complete outfits with intelligent randomization
    • Extensive Customization: 20+ outfit categories (torso, legs, feet, accessories, etc.)
    • Smart Presets: Curated presets per gender that auto-fill only empty fields
    • JSON-Based Data: Easily customizable outfit options via JSON files
    • Seed Management: Fixed, random, increment, and decrement modes

    πŸ€– AI-Powered Enhancement

    • Ollama LLM Integration: Enhance prompts with local AI models (✨ Ollama Prompter)
    • Simple Ollama: Streamlined prompt enhancement (🎯 Simple Ollama)
    • Vision Node Support: Describe images using vision-language models (πŸ‘οΈ Ollama Vision)
    • Style Helper: Professional photo styling assistance (πŸ“Έ Photo Style Helper)
    • Character Sheets: Generate detailed character turnarounds and expression sheets (πŸ‘€ Character Sheet Generator)

    🎨 Advanced Customization

    • Makeup UI: Animated, toggleable makeup editor with duplicate/clear controls
    • Style Controls: Art styles, lighting, cameras, and scene composition
    • Background Options: Diverse scene and environment settings
    • Age & Demographics: Comprehensive character customization
    • Avoid Terms: Add negative keywords (e.g., blurry, low-res) to refine outputs
    • Preset Export: Export current settings as JSON snippets for reuse
    • Preset Patch Applier: Apply and merge preset configurations (🧩 Preset Patch Applier)

    πŸ“¦ Installation

    Method 1: Git Clone (Recommended)

    cd ComfyUI/custom_nodes/
    git clone https://github.com/wizdroid/wizdroid-fashionista.git
    

    Method 2: Manual Download

    1. Download the latest release from the Releases page
    2. Extract to ComfyUI/custom_nodes/wizdroid-fashionista/

    Method 3: ComfyUI Manager

    1. Open ComfyUI Manager
    2. Search for "ComfyUI Outfit Selection"
    3. Click Install

    πŸš€ Quick Start

    Basic Usage

    1. Start ComfyUI
    2. Look for nodes in these categories:
      • Wizdroid/Outfits: Core outfit generation nodes
      • Wizdroid/AI: AI-powered enhancement nodes
      • Wizdroid/Utils: Utility and helper nodes

    Core Outfit Nodes

    • πŸ‘— Female Outfit Node: Generate female outfits with full customization
    • πŸ‘” Male Outfit Node: Generate male outfits with full customization

    AI Enhancement Nodes

    • ✨ Ollama Prompter: Advanced prompt enhancement with local AI models
    • 🎯 Simple Ollama: Streamlined prompt enhancement
    • πŸ‘οΈ Ollama Vision: Describe images using vision-language models
    • πŸ“Έ Photo Style Helper: Professional photo styling assistance

    Utility Nodes

    • πŸ‘€ Character Sheet Generator: Create character turnarounds, expression sheets, and action poses
    • 🧩 Preset Patch Applier: Apply and merge preset configurations
    • πŸ”„ Outfit Inputs from JSON: Bridge nodes for JSON-based outfit input

    Example Workflows

    Basic Outfit Generation

    [Female/Male Outfit Node] β†’ [Ollama Prompter] β†’ [Your Image Generation Model]
    

    Character Sheet Creation

    [Character Sheet Generator] β†’ [Text Output] β†’ [Image Generation Model]
    

    Advanced Workflow with Styling

    [Female Outfit Node] β†’ [Photo Style Helper] β†’ [Ollama Prompter] β†’ [Image Generation]
    

    Using Presets

    • Choose a Preset from the dropdown to auto-fill empty fields
    • Presets include pose, background, scene highlights (mood, time, color scheme), and optional makeup
    • You can override any field after applying a preset
    • Use "Export Preset" to save your current configuration as JSON

    Notes:

    • If a preset references an unknown key, the node logs a warning to help curate data
    • Presets are loaded from data/presets.json under keys by gender

    Character Sheet Generation

    The Character Sheet Generator creates detailed prompts for:

    • Character Turnarounds: Multiple angle views (front, side, back)
    • Expression Sheets: Emotional expressions and facial studies
    • Action Pose Sheets: Dynamic poses and movement studies
    • Outfit Sheets: Clothing and accessory variations
    • Anatomy Studies: Detailed anatomical references
    • Sprite Sheets: Game-ready character sprites

    Makeup Editor

    Avoid Terms

    • Use the Avoid field to list items you don’t want (comma-separated or free text).
    • These are appended as β€œAvoid: ...” in the final prompt.

    Export Preset

    • Toggle β€œexport_preset” to print a preset JSON snippet to the console.
    • Paste under your gender in data/presets.json and give it a name.
    • Click the Makeup field to open the editor.
    • Add items like lipstick, eyeliner, blush, highlighter, etc.
    • Use the Enable/Duplicate/Clear All controls for quick edits.

    πŸ“‹ Prerequisites

    Core Requirements

    Optional Dependencies (for AI Features)

    For AI prompt enhancement and vision capabilities:

    pip install -r requirements.txt
    

    Ollama Integration:

    • Install Ollama for local AI model support
    • Download models for different capabilities:
      • Text enhancement: ollama pull llama2, ollama pull mistral
      • Vision support: ollama pull llava, ollama pull moondream
      • Code generation: ollama pull codellama

    Vision Node Requirements:

    • Additional Python packages may be required for vision features
    • Models like llava and moondream provide image description capabilities

    🧩 Data & Extensibility

    Customizing Outfit Options

    • Edit JSON files in data/outfit/<gender>/*.json
    • Each file contains an attire array with outfit objects
    • The node automatically discovers parts and prepends control values: none, random

    Adding New Presets

    Edit data/presets.json:

    • Top-level keys: female, male
    • Under each gender, add presets by name mapping to { part_or_option_key: value }
    • Only valid input keys will be applied; invalid keys log warnings
    • Keep values aligned with available options in the corresponding JSONs

    Extending Styles and Scenes

    Modify files under data/styles/:

    • Scene Controls: mood, time_of_day, weather, color_scheme
    • Style Controls: description_style, creative_scale
    • Enhancement Data: Photo styling and prompt enhancement templates
    • All style definitions are easily customizable and extensible

    Character Sheet Templates

    The Character Sheet Generator supports multiple template types:

    • Turnaround Sheets: Multi-angle character views
    • Expression Studies: Facial expression variations
    • Action Poses: Dynamic movement and action shots
    • Outfit Variations: Clothing and accessory studies
    • Anatomy References: Detailed character studies

    πŸ“„ License

    This project is licensed under the MIT License. See the LICENSE file for details.

    License

    This project is licensed under the MIT License. See the LICENSE file for details.

    πŸ“ Project Structure

    wizdroid-fashionista/
    β”œβ”€β”€ nodes/                          # Core ComfyUI node implementations
    β”‚   β”œβ”€β”€ dynamic_outfit.py          # Main outfit generation nodes
    β”‚   β”œβ”€β”€ preset_node.py             # Preset management
    β”‚   └── preset_outfit_node.py      # Preset-based outfit nodes
    β”œβ”€β”€ support_nodes/                  # AI and utility support nodes
    β”‚   β”œβ”€β”€ character_sheet_generator.py # Character sheet creation
    β”‚   β”œβ”€β”€ ollama_llm.py              # Enhanced LLM integration
    β”‚   β”œβ”€β”€ ollama_vision.py           # Vision model support
    β”‚   β”œβ”€β”€ simple_ollama.py           # Simplified LLM interface
    β”‚   β”œβ”€β”€ style_helper.py            # Photo styling assistance
    β”‚   β”œβ”€β”€ preset_patch_applier.py    # Preset management
    β”‚   └── outfit_inputs_from_json.py # JSON bridge nodes
    β”œβ”€β”€ utils/                          # Shared utilities and libraries
    β”‚   β”œβ”€β”€ data_loader.py             # Data loading and caching
    β”‚   β”œβ”€β”€ prompt_builder.py          # Prompt construction
    β”‚   β”œβ”€β”€ common.py                  # Common utilities
    β”‚   └── ollama_base.py             # Base Ollama functionality
    β”œβ”€β”€ data/                           # JSON configuration files
    β”‚   β”œβ”€β”€ outfit/                    # Outfit definitions by gender
    β”‚   β”‚   β”œβ”€β”€ female/                # Female outfit categories
    β”‚   β”‚   └── male/                  # Male outfit categories
    β”‚   β”œβ”€β”€ styles/                    # Styling and enhancement data
    β”‚   β”œβ”€β”€ presets.json              # Curated outfit presets
    β”‚   β”œβ”€β”€ backgrounds.json          # Background options
    β”‚   β”œβ”€β”€ race.json                 # Character demographics
    β”‚   └── age_groups.json           # Age group definitions
    β”œβ”€β”€ web/                           # Custom UI components
    β”‚   β”œβ”€β”€ beautiful_ui.js           # Enhanced UI functionality
    β”‚   └── makeup_ui.js              # Makeup editor interface
    β”œβ”€β”€ tests/                         # Comprehensive test suite
    └── example_workflows/             # Example ComfyUI workflows