ComfyUI Extension: Eden.art nodesuite

Authored by edenartlab

Created

Updated

88 stars

Maintained by Eden.art, this is a growing suite of custom nodes for building advanced pipelines.

README

<div align="center"> <img src="assets/eden.png" alt="Eden.art Logo" width="300"> <h1>🌱 Eden ComfyUI Custom Node Suite</h1> <p>A comprehensive collection of specialized ComfyUI nodes for advanced generative AI workflows</p> <p><strong>Developed by <a href="https://www.eden.art/">Eden.art</a></strong></p> </div>

📖 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>