nodes/MushroomFleet-ComfyUI-Variationator
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
Files
main
MushroomFleet-ComfyUI-Varia…/QUICKSTART.md
T
Drift Johnson 4ca100c499 Add files via upload
2025-11-25 13:29:05 +00:00

13 KiB
Raw Permalink Blame History

Variationator Quick Start Guide

Get started with ComfyUI Variationator in 5 minutes

Version 2.0.0

What is Variationator?

Variationator is a powerful ComfyUI custom node pack that helps you create diverse prompt variations across 12 different dimensions:

🎨 240 Pre-defined Modifiers across Lighting, Seasonal, Location, Weather, Mood, Camera, Color Grading, Action, Era, Detail, Composition, and Distance

🔧 19 Custom Nodes for precise control or batch generation

🚀 Zero Setup - Just install and start using

Installation

Method 1: ComfyUI Manager (Recommended)

  1. Open ComfyUI Manager
  2. Search for "Variationator"
  3. Click Install
  4. Restart ComfyUI

Method 2: Manual Installation

cd ComfyUI/custom_nodes
git clone https://github.com/MushroomFleet/ComfyUI-Variationator.git
# Restart ComfyUI

After installation, all nodes appear under "Prompt Orchestration" category.

Your First Variation

Let's create your first prompt variation in 3 steps:

Step 1: Add a Text Node

  1. Right-click in ComfyUI workspace
  2. Add → text → String
  3. Enter your base prompt: "Sports car on highway"

Step 2: Add a Lighting Modifier Node

  1. Right-click in workspace
  2. Add → Prompt Orchestration → Lighting Modifier (Single)
  3. Connect your text to the text input
  4. Set modifier_id to 7 (Golden Hour)
  5. Keep preserve_base as True

Step 3: View the Result

Connect the modified_prompt output to your workflow and run!

Result: "Sports car on highway, golden hour, warm low-angle side-light, clear sky"

🎉 Congratulations! You've created your first variation.

Common Use Cases

Use Case 1: Day/Night Variations

Goal: Create the same scene at different times of day

Solution: Use Batch Variation Generator

  1. Add Batch Variation Generator node
  2. Input: "Modern building exterior"
  3. Category: "custom"
  4. Custom IDs: "1,7,11,18" (Sunrise, Golden Hour, Night Clear, Blue Hour Wet)
  5. Get 4 time-of-day variations as outputs

Use Case 2: Style Exploration

Goal: See your subject in different artistic styles

Solution: Use Style Transform node

  1. Add Style Transform node
  2. Input: "Vintage motorcycle"
  3. Try different styles:
    • cyberpunk → Neon-lit futuristic version
    • noir → Dramatic black & white mood
    • impressionist → Painterly interpretation

Use Case 3: Multi-Dimensional Variation

Goal: Create a complex, layered scene

Solution: Stack multiple modifier nodes

Base Prompt: "Product photography"
    ↓
Lighting Modifier #7 (Golden Hour)
    ↓
Location Modifier #14 (Studio environment)
    ↓
Mood Modifier #13 (Luxurious elegance)
    ↓
Camera Modifier #12 (Close-up framing)
    ↓
Final Output

Use Case 4: Random Exploration

Goal: Discover unexpected variations

Solution: Use Random Modifier node

  1. Add Random Modifier node
  2. Input: "City street"
  3. Category: "all"
  4. Seed: 12345
  5. Each time you change the seed, get a different lighting variation

Use Case 5: Natural Language

Goal: Quick variations without looking up IDs

Solution: Use Smart Variation node

  1. Add Smart Variation (NLP) node
  2. Input: "Car on road"
  3. Intent: "make it golden hour with wet road cyberpunk style"
  4. Get instant results with natural language

Understanding Modifiers

What are Modifiers?

Modifiers are pre-written prompt fragments that add specific characteristics:

  • Lighting #7: "golden hour, warm low-angle side-light, clear sky"
  • Seasonal #12: "mid autumn, peak foliage colors, amber lighting"
  • Weather #10: "steady rain, wet surfaces, rainfall atmosphere"

The 12 Dimensions

Dimension What It Controls Example Modifiers
Lighting Time of day, lighting conditions Sunrise, Golden Hour, Night
Seasonal Season and atmosphere Spring bloom, Summer heat, Autumn colors
Location Environment setting Urban downtown, Rural countryside, Studio
Weather Atmospheric conditions Clear sky, Storm, Fog
Mood Emotional tone Energetic, Mysterious, Luxurious
Camera Photography techniques Wide angle, Low angle, Close-up
Color Grading Color palette Warm tones, Cool blues, Cinematic
Action Dynamic state In motion, Stationary, Racing
Era Time period 1980s, Cyberpunk future, Steampunk
Detail Detail level and focus Ultra-detailed, Soft focus, Minimalist
Composition Framing technique Rule of thirds, Symmetrical, Negative space
Distance Spatial relationships & proximity Macro, Portrait distance, Aerial view

DRY vs WET

Some dimensions (Lighting, Seasonal, Weather) have DRY/WET categorization:

  • DRY: Clear conditions, bright, universal use
  • WET: Low-light, wet surfaces, reflections, dramatic

Node Categories

1. Single Modifier Nodes (12 nodes)

Use when: You want precise control over one aspect

Available: Lighting, Seasonal, Location, Weather, Mood, Camera, Color Grading, Action, Era, Detail, Composition, Distance

Each has:

  • text input - Your base prompt
  • modifier_id (1-20) - Which modifier to apply
  • preserve_base - Append (true) or replace (false)

2. Style Nodes (2 nodes)

Style Transform - Apply artistic styles

  • Built-in: cyberpunk, noir, minimalist, vintage, etc.
  • Custom: Define your own style

Multi-Style Layer - Stack multiple styles

  • Combine up to 3 styles sequentially
  • Creates unique hybrid aesthetics

3. Batch Nodes (2 nodes)

Batch Variation Generator - Up to 10 variations

  • Choose category or specific modifier IDs
  • Perfect for A/B testing

Preset Collection - Optimized sets

  • key_moments - Portfolio-ready shots
  • commercial - Product photography
  • artistic - Creative exploration
  • full_day_cycle - 24-hour progression
  • wet_night - Dramatic low-light

4. Utility Nodes (4 nodes)

Modifier Info - Look up modifier details Prompt Combiner - Join text segments Random Modifier - Randomize with seed control Smart Variation - Natural language control

Quick Tips

✅ Best Practices

  1. Start Simple - Use one modifier at a time initially
  2. Preserve Base - Keep preserve_base=True for most cases
  3. Stack Wisely - Combine 2-4 modifiers max for coherence
  4. Use Presets - Try preset collections for proven combinations
  5. Explore Tags - Use Modifier Info to understand what each does

⚠️ Common Mistakes

  1. Too Many Modifiers - Don't stack 10+ modifiers, prompts get chaotic
  2. Wrong IDs - Each dimension has IDs 1-20, check the reference
  3. Forgetting preserve_base - If output is wrong, check this toggle
  4. Not Using Custom IDs - Batch node's custom mode gives precise control

🔍 Troubleshooting

Problem: "My output is just the modifier text"

  • Solution: Set preserve_base=True

Problem: "All variations look the same"

  • Solution: Use modifiers from different categories (DRY vs WET, or different dimensions entirely)

Problem: "Prompt is too long"

  • Solution: Use fewer modifiers or set some to preserve_base=False

Problem: "Can't find a specific look"

  • Solution: Use Smart Variation with natural language description

Example Workflows

Workflow 1: Product Photography Set

Goal: 4 professional product shots

Base: "Luxury watch on pedestal"
    ↓
Preset Collection Node
    preset = "commercial"
    ↓
Outputs 4-6 variations:
- Late morning light
- Midday crisp
- Golden hour warm
- Night with highlights

Workflow 2: Artistic Portfolio

Goal: Same subject, different moods

Base: "Vintage car in garage"
    ↓
┌─────────┬─────────┬─────────┐
│         │         │         │
Lighting  Mood      Style     
#7        #12       "noir"    
│         │         │         
└─────────┴─────────┴─────────┘
    ↓
Combined Output: Golden hour + Noir atmosphere + Film noir style

Workflow 3: Season Comparison

Goal: All four seasons

Base: "Park landscape"
    ↓
Batch Variation Generator
    category = "custom"
    custom_ids = "3,8,12,17"
    ↓
- Spring (ID 3)
- Summer (ID 8)  
- Autumn (ID 12)
- Winter (ID 17)

Workflow 4: Random Discovery

Goal: Explore unexpected combinations

Base: "Street photography"
    ↓
Random Modifier (seed=42) → Lighting variation
    ↓
Random Modifier (seed=87) → Second lighting (different dimension)
    ↓
Style Transform ("random") → Artistic style

Keyboard Workflow Tips

  1. Find Nodes Fast - Type first few letters in Add menu

    • "light" → Lighting Modifier
    • "batch" → Batch Variation Generator
    • "smart" → Smart Variation

  2. Duplicate Modifier Chains - Select nodes → Ctrl+C → Ctrl+V

    • Quickly create parallel variation paths

  3. Group Related Nodes - Makes complex workflows manageable

  4. Label Your Outputs - Rename text nodes to identify variations

Next Steps

Beginner Level ✓

  • Install Variationator
  • Create first variation
  • Understand modifier IDs
  • Try each dimension once
  • Create a 3-variation batch

Intermediate Level

  • Stack 3+ modifiers from different dimensions
  • Use Preset Collections
  • Experiment with Style Transform
  • Build a reusable workflow template

Advanced Level

  • Create complex multi-path workflows
  • Combine with other ComfyUI nodes
  • Use Random Modifier for exploration
  • Master Smart Variation NLP
  • Design custom preset combinations

Learning Resources

In This Package

  • MODIFIER_REFERENCE.md - All 240 modifiers documented
  • NODE_REFERENCE.md - Complete node guide with examples
  • README.md - Project overview and features

Need Help?

  1. Check Modifier Info Node - Built-in documentation
  2. Review Examples - NODE_REFERENCE.md has workflows
  3. Experiment - Try different combinations!
  4. GitHub Issues - Report bugs or ask questions

Cheat Sheet

Most Popular Modifiers

Lighting:

  • #1 Sunrise
  • #7 Golden Hour ⭐ (Most popular)
  • #11 Night Clear
  • #18 Blue Hour Wet

Seasonal:

  • #5 Spring Rain
  • #7 Midsummer
  • #12 Mid Autumn
  • #17 Clear Winter

Location:

  • #1 Downtown Urban
  • #12 Showroom Interior
  • #16 Coastal Setting

Style:

  • cyberpunk ⭐
  • noir
  • minimalist
  • vintage

Quick Reference

preserve_base=True  → Append modifier
preserve_base=False → Replace with modifier only

DRY = Clear, bright conditions
WET = Low-light, wet surfaces

Batch categories:
- "all"    → All 20 modifiers
- "dry"    → Clear modifiers (1-16)
- "wet"    → Wet modifiers (17-20)
- "custom" → Your specified IDs

Your Workflow Checklist

Before running your workflow, check:

  • Base prompt is clear and descriptive
  • Modifier IDs are in range 1-20
  • preserve_base setting is intentional
  • Not stacking too many modifiers (keep it reasonable)
  • Outputs are connected properly
  • For batch: Category or custom_ids is set correctly

FAQ

Q: How many modifiers should I use? A: Start with 1-2, maximum 3-5 for complex scenes. More isn't always better.

Q: What's the difference between dimensions? A: Each dimension controls a different aspect: Lighting=time, Weather=conditions, Mood=feeling, Camera=technique, etc.

Q: Can I use modifiers from different dimensions together? A: Yes! That's the power of the system. Combine Lighting + Weather + Mood + Camera for rich scenes.

Q: Do I need to use all 12 dimensions? A: No. Use only what your scene needs. Even 1-2 dimensions create great variations.

Q: What's the best way to learn? A: Start with Lighting Modifier #7 (Golden Hour), then explore one dimension at a time.

Ready to create amazing variations? Start with the Lighting Modifier and experiment!

For detailed information:

Reference in New Issue View Git Blame Copy Permalink