ComfyUI Extension: Chye ComfyUI Toolset

Authored by chyer

Created 22 days ago

Updated 12 days ago

0 stars

A comprehensive toolset of ComfyUI custom nodes for latent generation, image processing, and workflow utilities

Custom Nodes (0)

README

Chye ComfyUI Toolset

A comprehensive collection of ComfyUI custom nodes organized by category for enhanced workflow productivity.

🎯 Features

🔹 Latent Tools

Model-Specific Aspect Ratios: Optimized presets for Flux, Qwen Image, and SDXL models
Phone Screen Sizes: Common mobile device resolutions including modern tall screens
Video Formats: Standard video resolutions from 480p to 4K including cinema formats
Social Media Formats: Optimized sizes for Instagram, TikTok, YouTube, Facebook, and Twitter
Smart Orientation Control: Automatic Portrait/Landscape switching
Precision Scaling: Multiplier with automatic rounding to multiples of 32
Batch Generation: Support for multiple latents at once

🔸 Post Process Tools

Realistic Film Grain: Apply photographic film grain simulation with ISO control
ARRI Halation Effect: Simulate film bloom around highlights with comprehensive color grading controls
Global Color Grading: Apply comprehensive color grading to entire images (temperature, saturation, tint, gamma, exposure, contrast)
Chromatic Aberration: Lens color fringing simulation with barrel distortion
Spatially Correlated Noise: Advanced noise generation using scipy for realistic grain patterns
Color Channel Control: Option for monochrome or colored grain effects

🔤 Prompt Tools

Multi-Provider LLM Integration: DeepSeek, OpenAI, Anthropic, and custom providers
Dual Template Systems: File-based templates AND editable text input options
Secure API Key Management: File-based storage with gitignore protection
Automatic Setup: Dedicated setup node creates folder structure with examples
Professional Templates: Photography, cinematic, and high-detail enhancement templates
Error Handling: Graceful degradation with comprehensive error reporting

📁 File Tools

📁 CYH File | Folder Filename Builder - Construct file paths with project name, subfolder, and filename
📄 CYH File | Text File Loader - Load text content from .txt files with trigger button and editable text box
📄 CYH File | Text File Editor - Editable text widget with action modes for controlling output behavior (use_input/use_edit_mute_input)
🎬 CYH File | Video Loader - Load video files from text paths for ComfyUI video processing

🔧 Utility Tools (Coming Soon)

Workflow helpers
Data conversion utilities
Debug and analysis tools

📦 Installation

Method 1: Git Clone (Recommended)

cd custom_nodes
git clone https://github.com/chyer/Chye-ComfyUI-Toolset.git
cd Chye-ComfyUI-Toolset
echo "Chye-ComfyUI-Toolset" > .git/.cnr-id

# Install dependencies
pip install -r requirements.txt

Method 2: Manual Copy

Copy the Chye-ComfyUI-Toolset folder to your ComfyUI custom_nodes directory
Important: Create a file named .cnr-id in the .git folder with content Chye-ComfyUI-Toolset to avoid workflow errors
```
echo "Chye-ComfyUI-Toolset" > .git/.cnr-id
```

Install dependencies:

cd Chye-ComfyUI-Toolset
pip install -r requirements.txt

Restart ComfyUI

🚀 Usage

Latent Tools

Find the nodes under the latent category:

Model-Specific Nodes

🔹 CYH Latent | Flux Aspect Ratio - Flux-optimized latent generation
🔹 CYH Latent | Qwen Aspect Ratio - Qwen Image-optimized latent generation
🔹 CYH Latent | SDXL Aspect Ratio - SDXL-optimized latent generation

Phone Screen Nodes

🔹 CYH Latent | Phone Aspect Ratio - Common mobile device resolutions

Video Format Nodes

🔹 CYH Latent | Video Aspect Ratio - Standard video resolutions and formats

Social Media Nodes

🔹 CYH Latent | Social Media Aspect Ratio - Optimized sizes for social platforms

Configuration Options:

Aspect Ratio: Choose from category-specific presets
Orientation: Portrait or Landscape (with smart defaults based on media type)
Multiplier: Scale resolution (0.1-10.0)
Batch Size: Number of latents to generate (1-64)

Example Workflow:

[🔹 CYH Latent | Flux Aspect Ratio] → [KSampler] → [VAE Decode]

Multiplier Example:

Model: SDXL
Aspect: 16:9
Orientation: Landscape
Multiplier: 1.5
→ Output: 1536×864 latent

🎬 Post Process Tools

Find the nodes under the post_process category:

🎬 CYH Post Process | Film Grain - Apply realistic film grain simulation
- Strength: Overall grain intensity (0.0 to 1.0)
- ISO: Simulated film sensitivity (100-6400)
- Grain Size: Particle size control (1.0-10.0)
- Colored: Toggle between monochrome or colored grain
🎬 CYH Post Process | ARRI Halation - Apply ARRI-style film bloom effect with comprehensive color grading
- Threshold: Highlight detection threshold (0-255)
- Blur Size: Glow effect size (1-101, odd numbers)
- Intensity: Halation strength (0.0 to 1.0)
- Temperature: Color temperature in Kelvin (1000-40000K) - warm to cool colors
- Saturation: Color intensity (0.0-2.0) - desaturated to oversaturated
- Tint: Green-magenta shift (-1.0 to 1.0) - green tint to magenta tint
- Gamma: Gamma correction (0.5-2.5) - flat to contrasty
- Exposure: Exposure adjustment in EV stops (-4.0 to 4.0) - dark to bright
- Contrast: Contrast adjustment (0.5-2.0) - low to high contrast
🎨 CYH Post Process | Global Color Grading - Apply comprehensive color grading to entire images
- Temperature: Color temperature in Kelvin (1000-40000K) - warm to cool colors
- Saturation: Color intensity (0.0-2.0) - desaturated to oversaturated
- Tint: Green-magenta shift (-1.0 to 1.0) - green tint to magenta tint
- Gamma: Gamma correction (0.5-2.5) - flat to contrasty
- Exposure: Exposure adjustment in EV stops (-4.0 to 4.0) - dark to bright
- Contrast: Contrast adjustment (0.5-2.0) - low to high contrast
🌈 CYH Post Process | Chromatic Aberration - Apply lens color fringing effect
- Preset: Quick configurations (None, Vintage, Modern, Extreme, Custom)
- Intensity: Master effect strength multiplier (0.0-2.0)
- Center: Adjustable distortion center point (0.0-1.0)
- Quality: Fast (bilinear) or High (bicubic) interpolation
- Advanced Controls: Individual RGB channel distortion coefficients (k1, k2, k3)

Preset Details:

None: No chromatic aberration
Vintage: Classic lens look with red/blue separation
Modern: Subtle modern lens character
Extreme: Strong artistic effect with complex distortion

Example Workflows:

[KSampler] → [VAE Decode] → [🎬 CYH Post Process | Film Grain]

[KSampler] → [VAE Decode] → [🎬 CYH Post Process | ARRI Halation]

[KSampler] → [VAE Decode] → [🌈 CYH Post Process | Chromatic Aberration]

[KSampler] → [VAE Decode] → [🎨 CYH Post Process | Global Color Grading]

## 🔤 Prompt Tools

Find the nodes under the **prompt_tools** category:

- **🔤 CYH Prompt Tools | Setup** - Creates folder structure and example templates
  - **Force Recreate**: Overwrite existing files (True/False)
  - **Output**: Status message with setup results

- **🔤 CYH Prompt Tools | Enhancer** - Uses LLM APIs to refine and enhance prompts
  - **Prompt**: Input prompt to enhance (multiline text)
  - **Template Path**: Path to template file (e.g., "providers/deepseek/professional_photo.txt")
  - **Provider**: LLM provider (DeepSeek, OpenAI, Anthropic, Custom)
  - **API Key Override**: Optional API key override (skips file lookup)
  - **Temperature**: Creativity control (0.0-1.0)
  - **Max Tokens**: Response length limit (100-4000)

- **🔤 CYH Prompt Tools | Enhancer (Editable)** - Alternative version with editable preprompt template
  - **Prompt**: Input prompt to enhance (multiline text)
  - **Preprompt Template**: Editable template text (must include {prompt} placeholder)
  - **Provider**: LLM provider (DeepSeek, OpenAI, Anthropic, Custom)
  - **API Key Override**: Optional API key override (skips file lookup)
  - **Temperature**: Creativity control (0.0-1.0)
  - **Max Tokens**: Response length limit (100-4000)

### Setup Instructions:

1. **Run Setup Node First**: Use "🔤 CYH Prompt Tools | Setup" to create folder structure
2. **Configure API Keys**: Edit files in `Presets/api_keys/` with your actual API keys
3. **Customize Templates**: Modify or create templates in `Presets/Preprompts/` subdirectories
4. **Use Enhancer**: Connect prompts to "🔤 CYH Prompt Tools | Enhancer" for refinement

### Example Templates:
- **Professional Photography**: Camera settings, lighting, composition techniques
- **Cinematic Style**: Film terminology, director styles, visual storytelling
- **High Detail**: Ultra-realistic textures, technical precision, intricate patterns

### Supported Providers:
- **DeepSeek**: Fast and cost-effective Chinese LLM
- **OpenAI**: GPT-4 Turbo for high-quality enhancements
- **Anthropic**: Claude models for nuanced prompt refinement
- **Custom**: Template-only mode without API calls

### Example Workflows:

[Text Input] → [🔤 CYH Prompt Tools | Enhancer] → [KSampler]

[🔤 CYH Prompt Tools | Setup] → [Configure API Keys] → [🔤 CYH Prompt Tools | Enhancer]

[Text Input] → [🔤 CYH Prompt Tools | Enhancer (Editable)] → [KSampler]


### When to Use Each Version:
- **File-based Enhancer**: Use when you want to maintain reusable templates across workflows
- **Editable Enhancer**: Use when you want to quickly modify or experiment with preprompt text directly in the node
- **Both versions support the same API providers and configuration options**

### Folder Structure:

Presets/ ├── api_keys/ # API key files (gitignored) │ ├── deepseek_api_key.txt │ ├── openai_api_key.txt │ └── anthropic_api_key.txt ├── Preprompts/ # Template files (.txt) │ ├── professional_photo.txt │ ├── cinematic.txt │ ├── high_detail.txt │ └── custom/ # User-defined templates

📁 File Tools

Find the nodes under the file category:

📁 CYH File | Folder Filename Builder - Construct file paths with project name, subfolder, and filename
- Project Name: Base project identifier
- Filename: Output filename (without extension)
- Use Subfolders: Enable/disable subfolder organization
- Delimiter: Path separator (/ or \ or _ or -)
- Subfolder: Optional subfolder name
📄 CYH File | Text File Loader - Load text content from .txt files with trigger button and editable text box
- File Path: Path to .txt file (supports drag & drop)
- Trigger: Load File button to load content
- Editable Text: Loaded text content (editable)
- Encoding: Text encoding (utf-8, utf-16, ascii, latin-1)
- Auto Load: Automatically reload when file changes
📄 CYH File | Text File Editor - Editable text widget with action modes for controlling output behavior
- Action: Control output behavior (use_input/use_edit_mute_input)
- Editable Text Widget: Editable text content
- Input Text: Optional upstream text input
🎬 CYH File | Video Loader - Load video files from text paths for ComfyUI video processing
- File Path: Path to video file (supports drag & drop)

Action Modes:

use_input: Outputs connected text and updates widget display
use_edit_mute_input: Outputs widget text and mutes upstream input

Example Workflows:

[📄 CYH File | Text File Loader] → [📄 CYH File | Text File Editor] → [KSampler]

[Text Input] → [📄 CYH File | Text File Editor] → [KSampler]

[🎬 CYH File | Video Loader] → [Get Video Components] (for extracting frames and audio)

[Video Generator] → [🎬 CYH File | Video Loader] (for loading generated videos)

[File Path] → [🎬 CYH File | Video Loader] → [Video Processing Nodes] (for video processing workflows)

When to Use Each Version:

Text File Loader: Use when you want to load text from .txt files
Text File Editor: Use when you want editable text with action modes and upstream muting
Video Loader: Use when you want to load video files from text paths for ComfyUI video processing
Combined: Use Text File Loader → Text File Editor for file loading with advanced editing features

📱 Phone Screen Resolutions

| Aspect Ratio | Resolution | Description | |-------------|------------|-------------| | 16:9 | 1080×1920 | Standard phone screens | | 19.5:9 | 1080×2340 | Modern tall phones | | 20:9 | 1080×2400 | Ultra tall phones | | 18:9 | 1080×2160 | Tall phones |

Default Orientation: Portrait (optimized for mobile viewing)

🎬 Video Format Resolutions

| Aspect Ratio | Resolution | Description | |-------------|------------|-------------| | 16:9 | 1920×1080 | Standard video (Full HD) | | 21:9 | 1920×810 | Cinema format | | 4:3 | 1024×768 | Traditional video | | 9:16 | 1080×1920 | Portrait video |

Default Orientation: Landscape (except 9:16 which defaults to Portrait)

📱 Social Media Resolutions

| Platform | Format | Resolution | Aspect Ratio | |----------|--------|------------|-------------| | Instagram | Square | 1080×1080 | 1:1 | | Instagram | Portrait | 1080×1350 | 4:5 | | Instagram | Landscape | 1080×608 | 1.91:1 | | Instagram | Stories/Reels | 1080×1920 | 9:16 | | TikTok | Standard | 1080×1920 | 9:16 | | TikTok | Wide | 1920×1080 | 16:9 | | YouTube | Standard | 1920×1080 | 16:9 | | YouTube | Shorts | 1080×1920 | 9:16 | | Facebook | Feed | 1200×630 | 1.91:1 | | Facebook | Stories | 1080×1920 | 9:16 | | Twitter | Tweet | 1200×675 | 16:9 | | Twitter | Header | 1500×500 | 3:1 |

Default Orientation: Platform-specific (Portrait for Instagram Stories/TikTok, Landscape for YouTube Standard, etc.)

📐 Resolution Reference

| Model | 1:1 | 4:3 | 3:2 | 16:9 | 21:9 | |------------|----------|----------|----------|----------|----------| | Flux | 1024×1024| 1280×960 | 1152×768 | 1344×768 | 1792×768 | | Qwen | 1328×1328| 1472×1140| 1536×1024| 1664×928 | 1984×864 | | SDXL | 1024×1024| 1024×768 | 1152×768 | 1024×576 | 1344×576 |

🏗️ Project Structure

Chye-ComfyUI-Toolset/
├── categories/
│   ├── latent_tools.py      # Aspect ratio latent generators
│   ├── post_process.py      # Image post-processing tools (film grain, etc.)
│   ├── prompt_tools.py      # LLM-based prompt enhancement tools
│   ├── image_tools.py       # Interactive painting and image processing tools
│   ├── file_tools.py        # File handling tools (text, video, etc.)
│   ├── video_tools.py       # Video loading tools for text path input
│   ├── utility_tools.py     # (Future) Workflow utilities
│   └── __init__.py
├── shared/
│   ├── constants.py         # Common configuration data
│   ├── validators.py        # Input validation utilities
│   ├── helpers.py          # Shared utility functions
│   └── __init__.py
├── Presets/                 # Prompt enhancement templates and API keys
│   ├── api_keys/           # API key files (gitignored)
│   └── Preprompts/         # Template files (.txt)
├── __init__.py             # Main entry point
├── pyproject.toml          # Project metadata
└── README.md              # This file


## 📝 Notes

- All dimensions are automatically rounded to multiples of 32 for ComfyUI compatibility
- Portrait orientation swaps width/height when the base resolution is landscape-oriented
- Multiplier scales base resolution before rounding
- Modular design allows for easy expansion with new tool categories
- Phone screen nodes default to Portrait orientation for optimal mobile viewing
- Video format nodes have smart defaults based on the aspect ratio (Landscape for most, Portrait for 9:16)
- Social media nodes have platform-specific default orientations for optimal results

## 🔄 Version History

- **v2.9.0**: Added Video Loader node for loading videos from text paths
- **v2.8.0**: Added Text File Editor node with action modes (use_input/use_edit_mute_input) and UI widget updating
- **v2.7.0**: Added Interactive Painter node with freehand brush drawing
- **v2.6.0**: Added Global Color Grading node with comprehensive color controls
- **v2.5.0**: Enhanced ARRI Halation node with comprehensive color grading controls
- **v2.4.0**: Added PromptEnhancerEditable node with editable preprompt templates
- **v2.3.0**: Added Prompt Enhancement tools with multi-provider LLM integration
- **v2.2.0**: Added Chromatic Aberration node with realistic lens simulation
- **v2.1.0**: Added Phone, Video, and Social Media aspect ratio nodes
- **v2.0.0**: Complete restructure into modular toolset with shared utilities
- **v1.x.x**: Individual aspect ratio nodes

## 🤝 Contributing

This toolset is designed for extensibility. New categories and tools can be easily added following the established patterns in the `categories/` and `shared/` directories.

---

**Happy Creating! 🎨**