Advanced KSampler node and professional post-processing tools for ComfyUI with multi-cycle sampling, progressive upscaling, and cinematic enhancement capabilities.

Overview

ComfyUI-KarmaNodes provides a comprehensive suite of nodes for advanced image generation and post-processing:

Karma KSampler Cycle: Specialized KSampler that performs multiple sampling cycles with progressive upscaling between cycles, enabling high-quality, high-resolution image generation with better detail preservation
Karma Film Grain: Professional film grain simulation for authentic analog film texture and cinematic aesthetics
Karma Kolors: Advanced color grading and correction tools for professional-grade color enhancement
Karma Lens FX: Realistic lens effect simulation — chromatic aberration, vignetting, barrel/pincushion distortion, and halation
Karma Tone Curves: Surgical tonal control — independent shadow/midtone/highlight adjustments, S-curve contrast, and split toning
Karma Film Emulation: One-click cinematic film stock emulation with 10 iconic presets from Kodak, Fuji, CineStill, and Ilford

Features

🔄 Multi-Cycle Sampling

Progressive Upscaling: Automatically upscales images between sampling cycles
Configurable Cycles: Support for 2-12 sampling cycles
Dynamic Parameters: Adjust sampling parameters between cycles

🎯 Advanced Sampling Control

Dual Model Support: Switch between primary and secondary models at specified cycles
Additive Conditioning: Blend additional positive/negative conditioning with strength scaling
Dynamic Denoise: Configurable denoise strength scaling with minimum threshold protection
Steps Scaling: Flexible steps adjustment with increment/decrement modes and threshold control
Threshold Management: Auto-calculated or manual threshold settings for precise control

🔧 Upscaling Options

Basic Upscaling: High-quality image rescaling with multiple resampling methods
Model-Based Upscaling: Use dedicated upscale models for enhanced quality
Gradual Upscaling: Multi-step upscaling for smoother transitions
Configurable Resampling: Separate methods for image and latent space upscaling
VAE Compatibility: Ensures dimensions are VAE-compatible (divisible by 8)

✨ Post-Processing

Sharpening Filter: Optional unsharp mask filter between cycles
Film Grain Effects: Realistic analog film grain simulation
Color Grading: Professional color correction and enhancement
Lens Effects: Chromatic aberration, vignetting, distortion, and halation
Tone Curves: Independent shadow/midtone/highlight control with split toning
Film Emulation: One-click cinematic looks from iconic film stocks
Tiled VAE Support: Handle large images with tiled VAE processing
Memory Management: Automatic device management for optimal performance

Installation

Method 1: ComfyUI Manager (Recommended)

Install ComfyUI Manager
Search for "KarmaNodes" in the manager
Install and restart ComfyUI

Method 2: Manual Installation

Navigate to your ComfyUI custom nodes directory:
```
cd ComfyUI/custom_nodes/
```

Clone this repository:

git clone https://github.com/karmaswint/ComfyUI-KarmaNodes.git

Install dependencies:

cd ComfyUI-KarmaNodes
pip install -r requirements.txt

Restart ComfyUI

Usage

Basic Workflow

Add the Node: Search for "Karma KSampler Cycle" in the node browser
Connect Inputs:
- Connect your model, VAE, and conditioning inputs
- Provide an initial latent image
Configure Parameters:
- Set the number of cycles (2-12)
- Configure upscale factor and method
- Adjust denoise strengths
Run: Execute the workflow

Key Parameters

Core Sampling

Steps: Number of sampling steps per cycle
Total Cycles: Number of upscaling/sampling cycles (2-12)
Starting Denoise: Denoise strength for the first cycle (0.0-1.0)
Cycle Denoise: Denoise strength for subsequent cycles (0.0-1.0)

Denoise Scaling

Enable Denoise Scaling: Automatically adjust denoise strength between cycles
Denoise Min Threshold: Minimum denoise value to prevent going too low (0.01-1.0)

Steps Scaling

Enable Steps Scaling: Automatically adjust sampling steps between cycles
Steps Scaling Value: Amount to adjust steps by each cycle (1-50)
Steps Adjustment Mode:
- decrement: Reduce steps each cycle (for refinement)
- increment: Increase steps each cycle (for more detail)
Steps Threshold Mode:
- auto: Automatically calculate threshold based on initial steps
- manual: Use a fixed threshold value
Steps Manual Threshold: Fixed threshold when using manual mode (1-200)

Upscaling

Upscale Factor: Total upscaling factor to achieve
Upscale Method:
- basic: High-quality image rescaling
- model: Use dedicated upscale model (requires upscale_model input)
Scale Sampling: Resampling method for image upscaling (bilinear, bicubic, nearest, lanczos)
Latent Upscale Method: Resampling method for latent space upscaling (bilinear, bicubic, nearest, lanczos)
Enable Gradual Upscaling: Use multiple intermediate upscaling steps for smoother transitions
Gradual Upscale Steps: Number of intermediate steps when gradual upscaling is enabled (1-10)

Advanced Features

Secondary Model: Optional model to switch to at specified cycle
Secondary Model Start Cycle: Cycle number to switch to secondary model (1-12)
Additive Conditioning: Additional positive/negative prompts with strength control
Sharpening: Apply unsharp mask filter between cycles

Example Workflow

[Model] → [Karma KSampler Cycle] → [VAE Decode] → [Save Image]
[VAE] ↗                        ↘ [VAE]
[Positive Conditioning] ↗
[Negative Conditioning] ↗
[Empty Latent] ↗

Advanced Usage

Dual Model Workflow

Use different models for different phases of generation:

Connect primary model for initial cycles
Connect secondary model (optional)
Set "Secondary Model Start Cycle" to switch models mid-process

Additive Conditioning

Enhance your prompts with additional conditioning:

Connect main positive/negative conditioning
Connect additive positive/negative conditioning (optional)
Adjust strength values and scaling options

High-Resolution Generation

For very high-resolution outputs:

Start with lower resolution latent
Set higher upscale factor (2.0-4.0)
Use more cycles (4-8) for gradual upscaling
Enable tiled VAE for memory efficiency

Steps Scaling Strategies

Decrement Mode (Refinement Strategy)

Best for progressive refinement with fewer steps in later cycles:

Use Case: When you want detailed initial generation, then refinement
Configuration:
- Steps Adjustment Mode: decrement
- Steps Scaling Value: 3-8 (moderate reduction)
- Threshold Mode: auto (prevents going too low)
Example: 20 → 15 → 10 → 5 steps across 4 cycles

Increment Mode (Detail Enhancement Strategy)

Best for progressive detail enhancement with more steps in later cycles:

Use Case: When you want quick initial generation, then detailed refinement
Configuration:
- Steps Adjustment Mode: increment
- Steps Scaling Value: 5-10 (moderate increase)
- Threshold Mode: manual with reasonable cap (e.g., 50)
Example: 10 → 15 → 20 → 25 steps across 4 cycles

Gradual Upscaling

For smoother upscaling transitions:

Enable "Gradual Upscaling"
Set "Gradual Upscale Steps" to 3-5
Use with higher upscale factors (3.0+) for best results

Post-Processing Nodes

ComfyUI-KarmaNodes includes specialized post-processing nodes for enhancing your generated images with professional-grade effects and color corrections.

🎬 Karma Film Grain

Add authentic analog film grain texture to your images for a cinematic, vintage aesthetic.

Features

Realistic Multi-Layer Grain: Combines multiple noise layers for authentic film texture
Luminance-Based Intensity: More grain in darker areas, mimicking real film behavior
Configurable Parameters: Adjustable grain strength and particle size
Reproducible Results: Seed-based grain patterns for consistent outputs
Fallback Support: Works even without scipy dependency

Parameters

Strength (0.01-1.0): Intensity of the film grain effect
Grain Size (0.1-5.0): Size/scale of grain particles
Seed (0-2³¹-1): Random seed for reproducible grain patterns

Usage Tips

Subtle Effects: Use strength values 0.05-0.15 for realistic film look
Vintage Style: Higher strength (0.2-0.4) with larger grain size (2.0-3.0)
Fine Detail: Smaller grain size (0.5-1.0) for high-resolution images
Consistency: Use the same seed across similar images for matching grain patterns

🎨 Karma Kolors

Professional color grading and correction tools for precise image enhancement.

Features

White Balance Correction: Temperature-based color correction (2000K-10000K)
Brightness Control: Precise brightness adjustments (-20% to +20%)
Contrast Enhancement: Professional contrast control with fine increments
Saturation Adjustment: Color intensity control for vibrant or muted looks
Optimal Processing Order: Adjustments applied in the correct sequence for best results

Parameters

White Balance: Temperature in Kelvin (2000K-10000K) or "auto"
- 2000K-3000K: Warm, candlelight tones
- 3000K-4000K: Warm white, tungsten lighting
- 5000K-6500K: Daylight, neutral white
- 6500K-10000K: Cool, blue-tinted lighting
Brightness (-20% to +20%): Overall image brightness in 0.5% increments
Contrast (-20% to +20%): Contrast adjustment in 0.5% increments
Saturation (-20% to +20%): Color intensity in 0.5% increments

Usage Tips

Natural Corrections: Start with small adjustments (±2-5%)
Creative Looks: Combine temperature shifts with saturation changes
Portrait Enhancement: Slight brightness (+2-5%) and contrast (+3-8%)
Landscape Vibrancy: Increase saturation (+5-10%) with slight contrast boost
Vintage Look: Warm temperature (3000K-4000K) with reduced saturation (-5-10%)

🔍 Karma Lens FX

Simulate real-world optical imperfections for authentic photographic character. Recreates the optical characteristics of physical camera lenses.

Features

Chromatic Aberration: Color fringing that increases toward image edges, simulating lateral CA
Vignetting: Smooth radial edge darkening with adjustable falloff curve
Lens Distortion: Barrel (positive) and pincushion (negative) geometric distortion
Halation: Highlight bloom/glow effect that simulates light scatter in film and lenses
Independent Controls: Each effect can be dialed in precisely without affecting others

Parameters

Chromatic Aberration (0-20): Color fringing strength in pixels
Vignette Strength (0-1): Edge darkening intensity
Vignette Falloff (0.5-5.0): Gradient steepness (higher = tighter bright center)
Distortion (-1 to 1): Barrel (+) or pincushion (-) distortion amount
Halation Strength (0-1): Highlight bloom intensity
Halation Threshold (0-1): Brightness level above which bloom is applied
Halation Radius (1-50): Spread of the bloom glow in pixels

Usage Tips

Subtle Realism: Chromatic aberration 1-3, vignette 0.1-0.2 for natural lens character
Vintage Lens Look: Chromatic aberration 5-10, vignette 0.3-0.5, distortion 0.1-0.2
Dreamy/Ethereal: Halation strength 0.3-0.5 with lower threshold (0.6-0.7)
Night Photography: Halation strength 0.2-0.4 with high threshold (0.85-0.95) for light glow
Cinematic: Combine vignette (0.2-0.3) with subtle halation (0.1-0.2) for movie look

📈 Karma Tone Curves

Surgical tonal control with independent shadow, midtone, and highlight adjustments — like a simplified version of Lightroom's tone curve panel.

Features

Zone-Based Adjustments: Independent shadow, midtone, and highlight brightness control
S-Curve Contrast: Midtone contrast adjustment for punchy or flat looks
Black/White Point: Clip shadows and highlights for controlled dynamic range
Split Toning: Independently tint shadows and highlights with any hue
Smooth Transitions: Cosine-weighted zone blending prevents banding

Parameters

Shadows (-1 to 1): Shadow brightness (negative = crush blacks, positive = lift shadows)
Midtones (-1 to 1): Midtone brightness (gamma-like adjustment)
Highlights (-1 to 1): Highlight brightness (negative = recover, positive = blow out)
Midtone Contrast (-1 to 1): S-curve contrast (positive = punchier, negative = flatter)
Black Point (0-0.3): Raise the darkest level for a faded/matte look
White Point (0.7-1.0): Lower the brightest level to tame highlights
Shadow Tint Hue (0-1): Color hue for shadow tinting
Shadow Tint Strength (0-0.5): Intensity of shadow color tint
Highlight Tint Hue (0-1): Color hue for highlight tinting
Highlight Tint Strength (0-0.5): Intensity of highlight color tint

Usage Tips

Faded Film Look: Black point 0.05-0.1, shadows +0.1, contrast -0.1
Punchy Modern: Midtone contrast +0.3-0.5, shadows -0.1
Teal & Orange Split Tone: Shadow tint hue 0.52, highlight tint hue 0.08, both at strength 0.1-0.15
Matte Finish: Black point 0.05-0.08, white point 0.92-0.95
High Key: Shadows +0.2, midtones +0.1, highlights +0.1

🎞️ Karma Film Emulation

One-click cinematic film stock emulation with 10 carefully calibrated presets. Each preset replicates the complete color science of an iconic analog film — color response, contrast curve, grain, and special characteristics.

Supported Film Stocks

Color Negative: | Film Stock | Character | |---|---| | Kodak Portra 400 | Natural skin tones, soft contrast, warm pastels. Portrait gold standard. | | Kodak Ektar 100 | Ultra-vivid colors, fine grain, high saturation. Landscape and travel. | | Kodak Gold 200 | Warm, golden highlights, nostalgic everyday look. | | Fuji Velvia 50 | Extreme saturation, deep contrast, vivid greens/blues. Landscape legend. | | Fuji Pro 400H | Soft pastels, airy skin tones, subtle greens. Wedding favorite. | | Fuji Superia 400 | Cool tones, strong greens/blues, punchy contrast. Classic consumer film. |

Cinema: | Film Stock | Character | |---|---| | CineStill 800T | Tungsten-balanced, teal shadows, warm highlights, halation on lights. Night photography icon. | | Kodak Vision3 500T | Professional cinema negative. Refined color, modern movie look. |

Black & White: | Film Stock | Character | |---|---| | Kodak Tri-X 400 | Rich tones, beautiful grain, deep blacks. Street photography legend. | | Ilford HP5 Plus | Smooth tones, moderate grain, excellent latitude. Versatile B&W workhorse. |

Parameters

Film Stock: Select the film to emulate from the dropdown
Intensity (0-1.5): Blend strength (0 = original, 1 = full emulation, >1 = exaggerated)
Grain Override (-1 to 1): Override grain amount (-1 = use film's default, 0+ = custom)
Seed (0-2³¹-1): Random seed for reproducible grain patterns

Usage Tips

Natural Look: Intensity 0.7-0.9 for believable film emulation
Heavy Stylization: Intensity 1.2-1.5 for exaggerated film character
Clean Film Color: Use grain override of 0 to get film color without grain
CineStill Night Shots: Works best with images that have bright light sources (halation glow)
B&W Conversion: Tri-X or HP5 presets automatically convert to monochrome with proper grain

Post-Processing Workflow Examples

Basic Enhancement Chain

[Generated Image] → [Karma Kolors] → [Karma Film Grain] → [Save Image]

Professional Color Grading

[Generated Image] → [Karma Kolors] → [Additional Processing] → [Final Output]
                     ↓
                   White Balance: 5500K
                   Brightness: +3.0%
                   Contrast: +5.0%
                   Saturation: +2.0%

Cinematic Film Look

[Generated Image] → [Karma Kolors] → [Karma Film Grain] → [Save Image]
                     ↓                ↓
                   Warm tone (3200K)   Strength: 0.12
                   Contrast: +8%       Grain Size: 1.5
                   Saturation: -3%     Seed: 42

Full Camera Simulation Pipeline

[Generated Image] → [Karma Tone Curves] → [Karma Kolors] → [Karma Lens FX] → [Karma Film Grain] → [Save Image]

Apply tonal adjustments first, then color grading, then optical effects, and finally grain — mimicking the order of a real camera and film pipeline.

One-Click Film Emulation

[Generated Image] → [Karma Film Emulation] → [Save Image]
                     ↓
                   Film Stock: CineStill 800T
                   Intensity: 0.85
                   Grain Override: -1 (use default)

For quick cinematic looks without manual tuning.

Stacked Precision + Emulation

[Generated Image] → [Karma Tone Curves] → [Karma Film Emulation] → [Karma Lens FX] → [Save Image]

Use Tone Curves for surgical adjustments, then Film Emulation for the overall look, and Lens FX for optical character.

Requirements

Python: 3.9+
PyTorch: 2.0.0+
Pillow: 9.0.0+
NumPy: 1.21.0+
scikit-image: 0.19.0+
ComfyUI: Latest version

Optional Dependencies

scipy: 1.9.0+ (recommended for enhanced film grain quality)
colorsys: Built-in Python module (used for color space conversions)

Performance Tips

Memory Management: Enable tiled VAE for large images
Cycle Count: More cycles = better quality but longer processing time
Upscale Factor: Higher factors require more VRAM
Model Selection: Use appropriate models for your target resolution

Troubleshooting

Common Issues

Out of Memory Errors:

Enable tiled VAE processing
Reduce upscale factor or number of cycles
Use smaller initial latent size
Disable gradual upscaling to reduce intermediate steps

Poor Quality Results:

Increase number of cycles
Adjust denoise strengths and enable denoise scaling
Try different upscaling methods
Enable sharpening filter
Use steps scaling with increment mode for more detail in later cycles
Enable gradual upscaling for smoother transitions

Slow Performance:

Reduce number of cycles
Use basic upscaling instead of model-based
Use steps scaling with decrement mode to reduce steps in later cycles
Disable gradual upscaling
Use auto threshold mode for steps scaling

Steps Scaling Issues:

Steps going too low: Use manual threshold mode with appropriate minimum
Steps going too high: Use manual threshold mode with reasonable maximum
Inconsistent results: Try auto threshold mode for balanced scaling

Post-Processing Issues:

Film grain too strong: Reduce strength value (try 0.05-0.10 for subtle effects)
Grain pattern inconsistent: Use the same seed value across related images
Color corrections too harsh: Use smaller adjustment increments (±1-3%)
White balance not working: Ensure temperature value is within 2000K-10000K range
Scipy warning for film grain: Install scipy for better grain quality: pip install scipy
Lens FX chromatic aberration not visible: Increase value above 2-3 for noticeable effect
Tone Curves banding: Use smaller adjustment values; the node uses smooth blending to minimize this
Film Emulation too intense: Lower the intensity slider to 0.6-0.8 for a more subtle look

Contributing

Contributions are welcome! Please feel free to submit issues, feature requests, or pull requests.

License

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

Acknowledgments

Built for the ComfyUI ecosystem
Inspired by progressive sampling techniques in diffusion models
Thanks to the ComfyUI community for feedback and testing

Support

Issues: GitHub Issues
Discussions: GitHub Discussions
Email: [email protected]

☕ Support Development

If you find ComfyUI-KarmaNodes useful and want to support future development, consider buying me a coffee! Your support helps maintain and improve these tools, develop new features, and keep everything free and open-source.

☕ Buy me a coffee

Every contribution, no matter how small, is greatly appreciated and directly contributes to:

🚀 New node development and features
🐛 Bug fixes and performance improvements
📚 Better documentation and tutorials
🔧 Ongoing maintenance and support

Thank you for being part of the ComfyUI-KarmaNodes community! 🙏

Note: This node is designed for advanced users familiar with ComfyUI workflows. Basic knowledge of diffusion model sampling is recommended.

Karma Before/After

A professional image comparison node for creating publication-ready before/after visualizations. Perfect for showcasing post-processing effects, model comparisons, upscaling results, or any A/B comparison.

Layout Modes

| Mode | Description | |------|-------------| | side_by_side | Images placed next to each other with an optional gap | | split_horizontal | Left/right split with a vertical divider (slider-style) | | split_vertical | Top/bottom split with a horizontal divider | | blend | Opacity crossfade between both images |

Parameters

| Parameter | Type | Default | Range | Description | |-----------|------|---------|-------|-------------| | before_image | IMAGE | — | — | The "before" image input | | after_image | IMAGE | — | — | The "after" image input | | mode | COMBO | split_horizontal | 4 options | Layout mode for the comparison | | split_position | FLOAT | 0.5 | 0.0–1.0 | Position of the split/blend point | | divider_width | INT | 3 | 0–20 | Width of the divider line (0 = hidden) | | divider_color | COMBO | white | white/black/red/gray | Color of the divider line | | show_labels | COMBO | none | none/simple/outlined | Label overlay style | | label_size | COMBO | medium | small/medium/large | Size of the labels | | gap_width | INT | 4 | 0–100 | Gap between images in side-by-side mode | | background_color | COMBO | black | black/white/gray | Gap/background fill color | | resize_mode | COMBO | match_before | 4 options | How to handle mismatched image sizes | | before_label | STRING | "Before" | any text | Custom label for the before image | | after_label | STRING | "After" | any text | Custom label for the after image |

Resize Modes

| Mode | Behavior | |------|----------| | match_before | Resize the after image to match the before image dimensions | | match_after | Resize the before image to match the after image dimensions | | match_larger | Resize both to the larger of the two dimensions | | match_smaller | Resize both to the smaller of the two dimensions |

Tips

Split modes include small triangular indicators at the divider edges for a polished slider look.
Use outlined labels for maximum readability over any background — they render white text with a dark outline.
The blend mode is great for spotting subtle differences — animate split_position from 0 to 1 to create a "wipe" effect.
Set divider_width to 0 for a seamless split without any visible line.
When comparing images of different sizes, match_before is usually the safest choice.

Workflow Example: Full Post-Processing Showcase

[Generate Image] → [Save as "Before"]
                 → [Karma Film Emulation] → [Karma Lens FX] → [Karma Tone Curves]
                 → [Save as "After"]

[Before] + [After] → [Karma Before/After (split_horizontal, show_labels=outlined)]
                   → [Preview / Save]