ComfyUI Extension: Eden.art nodesuite
Maintained by Eden.art, this is a growing suite of custom nodes for building advanced pipelines.
Custom Nodes (68)
- Animation_RGB_Mask
- AspectPadImageForOutpainting
- CLIP_Interrogator
- ConvertToGrayscale
- DepthSlicer
- Eden_Bool
- Eden_BoolBinaryOperation
- Eden_Compare
- Eden_Debug_Anything
- Eden_DebugPrint
- Eden_DepthSlice_MaskVideo
- Eden_DetermineFrameCount
- Eden_Face_Crop
- Eden_FaceToMask
- Eden_Float
- Eden_FloatToInt
- Eden_gpt4_node
- Eden_GPTPromptEnhancer
- Eden_ImageMaskComposite
- Eden_Image_Math
- Eden_IMG_padder
- Eden_IMG_unpadder
- Eden_Int
- Eden_IntToFloat
- Eden_Lora_Loader
- Eden_MaskBoundingBox
- Eden_MaskCombiner
- Eden_Math
- Eden_randbool
- Eden_RandomPromptFromFile
- Eden_Regex_Replace
- Eden_RepeatLatentBatch
- Eden_Seed
- Eden_String
- Eden_StringHash
- Eden_StringReplace
- Extend_Sequence
- Filepicker
- FolderScanner
- Get_Prefixed_Imgs
- GetRandomFile
- HistogramMatching
- If ANY execute A else B
- ImageDescriptionNode
- ImageFolderIterator
- IMG_blender
- IMG_padder
- IMG_resolution_multiple_of
- IMG_scaler
- IMG_unpadder
- IP_Adapter_Settings_Distribution
- KeyframeBlender
- LatentTypeConversion
- Linear_Combine_IP_Embeds
- Load_Embeddings_From_Folder
- LoadImagesByFilename
- LoadRandomImage
- MaskFromRGB
- MaskFromRGB_KMeans
- ParallaxZoom
- Random_Style_Mixture
- SaveImageAdvanced
- SavePosEmbeds
- SDAnyConverter
- SDTypeConverter
- VAEDecode_to_folder
- VideoFrameSelector
- WidthHeightPicker
README
📖 Overview
This repository contains 70+ custom ComfyUI nodes designed to enhance creative AI workflows with advanced image processing, depth manipulation, AI-powered text generation, logical operations, and sophisticated video effects. These nodes power many of the creative tools available on Eden.art.
🚀 Quick Start
Installation
cd ComfyUI/custom_nodes/
git clone https://github.com/edenartlab/eden_comfy_pipelines.git
cd eden_comfy_pipelines
pip install -r requirements.txt
OpenAI Setup (Optional)
For GPT-powered nodes, create a .env
file in your ComfyUI root directory:
OPENAI_API_KEY=your_api_key_here
🎯 Node Categories
🤖 AI & GPT Integration
GPT4 Text Completion
<img src="assets/eden_gpt4_node.jpg" alt="GPT4 Node" width="400">Advanced text generation with GPT-4 integration:
- Eden_gpt4_node: Direct GPT-4 API integration with customizable models (gpt-4o, gpt-4-turbo)
- Eden_GPTPromptEnhancer: Intelligently enhance basic prompts with detailed descriptions and artistic elements
- Eden_GPTStructuredOutput: Generate structured JSON responses following custom schemas
GPT4 Vision & Image Analysis
<img src="assets/imagedescriptionnode.jpg" alt="GPT4 Vision Node" width="400">Powerful image understanding capabilities:
- ImageDescriptionNode: Generate detailed captions and descriptions from images
- CLIP_Interrogator: Extract comprehensive text descriptions using CLIP + BLIP models
🖼️ Advanced Image Processing
Smart Image Loading & Management
<img src="assets/loadrandomimage.jpg" alt="LoadRandomImage Node" width="400">Intelligent batch processing tools:
- LoadRandomImage: Process multiple images with automatic aspect ratio correction
- ImageFolderIterator: Sequential image loading with index-based selection
- LoadImagesByFilename: Batch load images by filename patterns
Precision Image Manipulation
<img src="assets/SaveImage.png" alt="Enhanced SaveImage Node" width="400">Professional image handling:
- SaveImageAdvanced: Enhanced saving with timestamps and metadata export
- VAEDecode_to_folder: Direct-to-disk VAE decoding for long sequences
- IMG_padder/IMG_unpadder: Smart padding with edge-color matching
- IMG_scaler: Mathematical operations on pixel values
- IMG_blender: Advanced image blending with weight control
Color & Mask Generation
<img src="assets/maskfromrgb_kmeans.jpg" alt="Color Clustering Mask" width="400">Advanced segmentation tools:
- MaskFromRGB_KMeans: Generate precise masks using K-means color clustering
- Eden_MaskCombiner: Combine multiple masks with sophisticated blending
- ConvertToGrayscale: Professional grayscale conversion with alpha handling
- HistogramMatching: Match color distributions between images
🎭 Face Processing & Detection
Comprehensive face manipulation toolkit:
- Eden_FaceToMask: Automatic face detection and mask generation using MediaPipe
- Eden_Face_Crop: Intelligent face cropping with padding and boundary handling
- Eden_ImageMaskComposite: Advanced image compositing with mask support
📐 Depth & 3D Effects
Depth Analysis & Manipulation
<img src="assets/depthslicer.jpg" alt="DepthSlicer Node" width="400">Create stunning depth-based effects:
- DepthSlicer: Generate targeted masks from depth maps using K-means clustering
- Eden_DepthSlice_MaskVideo: Animated depth slicing for video sequences
- ParallaxZoom: 3D parallax effects from depth maps
3D Parallax Animation
<img src="assets/parallaxzoom.jpg" alt="Parallax Zoom Effect" width="400">- ParallaxZoom: Create immersive Deforum-style 3D zoom effects
- AspectPadImageForOutpainting: Intelligent padding for consistent aspect ratios
🎲 Logic & Control Flow
Data Types & Comparisons
<img src="assets/random_number.jpg" alt="Random Number Sampler" width="400">Essential workflow control nodes:
- Eden_RandomNumberSampler: Visual random number generation with live display
- Eden_Compare: Advanced comparison operations for any data type
- Eden_IfExecute: Conditional execution based on boolean logic
- Eden_BoolBinaryOperation: Boolean algebra operations (AND, OR, XOR, etc.)
Utilities & Conversion
- Eden_String/Int/Float/Bool: Type conversion and value passing
- Eden_Math: Mathematical operations on numeric values
- Eden_StringHash: Generate deterministic hashes from strings
- Eden_Debug_Anything: Comprehensive debugging with type analysis
📁 File & Data Management
File Operations
- GetRandomFile: Random file selection from directories
- FolderScanner: Comprehensive folder analysis and file listing
- Eden_AllMediaLoader: Load various media types with validation
- Eden_Save_Param_Dict: Export workflow parameters as JSON
Random Sampling & Selection
- Eden_RandomFilepathSampler: Statistical file path sampling
- Eden_RandomPromptFromFile: Load random prompts from text files
- Eden_randbool: Random boolean generation with probability control
🎬 Video & Animation
Video Processing
<img src="assets/parallaxzoom.jpg" alt="Video Effects" width="400">Advanced video manipulation:
- VideoFrameSelector: Intelligent frame selection with temporal optimization
- KeyframeBlender: Smooth keyframe interpolation for animations
- MaskedRegionVideoExport: Export specific regions from video sequences
- Extend_Sequence: Loop and extend video sequences with various modes
Animation Tools
- Animation_RGB_Mask: Create animated masks from RGB data
- AnimatedShapeMaskNode: Generate animated geometric masks
- OrganicFillNode: Organic mask filling for seamless animations
🔄 IP Adapter & Embeddings
Advanced conditioning and style transfer:
- Random_Style_Mixture: Blend multiple style embeddings randomly
- Linear_Combine_IP_Embeds: Linear combination of IP adapter embeddings
- SavePosEmbeds/Load_Embeddings_From_Folder: Embedding management system
- IP_Adapter_Settings_Distribution: Control IP adapter influence distribution
🎨 Featured Workflows
The repository includes example workflows in example_workflows/
showcasing:
- 3D Animation: Depth-based parallax effects
- Audio Processing: Stem separation and audio manipulation
- Face Styling: Expression transfer and face manipulation
- Video Effects: Frame blending and time remapping
- AI Generation: FLUX, SDXL, and other model workflows
🛠️ Technical Features
Memory Optimization
- LatentTypeConversion: Convert between float16/float32 for memory efficiency
- Eden_RepeatLatentBatch: Efficient latent batch processing
- Smart tensor management across GPU/CPU
Resolution & Aspect Ratio
- WidthHeightPicker: Smart resolution selection with multiple constraints
- IMG_resolution_multiple_of: Ensure dimensions are multiples of specific values
- AspectPadImageForOutpainting: Professional aspect ratio handling
String & Text Processing
- Eden_StringReplace: Advanced string replacement with regex support
- Eden_Regex_Replace: Powerful regex pattern matching
- Eden_RandomPromptFromFile: Dynamic prompt loading from files
🎯 Use Cases
- Creative AI Workflows: Professional image and video generation
- Batch Processing: Automated processing of large image sets
- 3D Effects: Depth-based animations and parallax effects
- Face Processing: Portrait enhancement and manipulation
- Content Creation: Automated caption generation and description
- Video Production: Advanced video effects and frame manipulation
- Research & Development: Experimental AI workflows and testing
📚 Contributing
We welcome contributions! For workflow contributions, check out our production workflows repository: edenartlab/workflows
📄 License
This project is licensed under the MIT License - see the LICENSE file for details.
<div align="center"> <p><strong>🌱 Built with ❤️ by the Eden.art team</strong></p> <p><a href="https://www.eden.art/">Visit Eden.art</a> | <a href="https://github.com/edenartlab/workflows">Production Workflows</a></p> </div>