Lucy Edit Installation Guide

Prerequisites

Before installing Lucy Edit, ensure you have Python 3.8 or higher and ComfyUI installed on your system. The following dependencies are required for core functionality.

System Requirements

  • • Python 3.8 or higher
  • • ComfyUI installation
  • • CUDA-compatible GPU (recommended)
  • • At least 8GB RAM
  • • 10GB free disk space for model weights

Important Note

Lucy Edit requires ComfyUI as the base framework. Make sure you have ComfyUI properly installed before proceeding with the Lucy Edit installation.

Installation Steps

Follow these steps to install Lucy Edit in your ComfyUI environment.

Step 1: Clone the Repository

cd ComfyUI/custom_nodes
git clone https://github.com/DecartAI/Lucy-Edit-ComfyUI.git
cd Lucy-Edit-ComfyUI

This downloads the Lucy Edit custom node into your ComfyUI custom_nodes directory.

Step 2: Install Dependencies

pip install -r requirements.txt

This installs all required Python packages for Lucy Edit functionality.

Step 3: Download Model Weights

Choose the appropriate weights for your setup:

FP16 Weights (Recommended)

Smaller file size, faster processing

wget https://huggingface.co/decart-ai/Lucy-Edit-Dev-ComfyUI/resolve/main/lucy-edit-dev-cui-fp16.safetensors

FP32 Weights

Higher precision, larger file size

wget https://huggingface.co/decart-ai/Lucy-Edit-Dev-ComfyUI/resolve/main/lucy-edit-dev-cui.safetensors

Place the downloaded weights under: ComfyUI/models/diffusion_models/

Usage Options

Lucy Edit offers two deployment options depending on your needs and preferences.

Lucy Edit Pro (API)

Access Lucy Edit through our cloud API for the most convenient experience.

Setup Steps:

  1. 1. Load the workflow from examples/basic-api-lucy-edit.json
  2. 2. Get an API key from platform.decart.ai
  3. 3. Configure the API key in ComfyUI
  4. 4. Start editing videos with text prompts

Benefits:

  • • No local GPU requirements
  • • Automatic updates
  • • Scalable processing
  • • Pay-per-use pricing

Lucy Edit Dev (Local)

Run Lucy Edit locally for complete control and privacy.

Setup Steps:

  1. 1. Load the workflow from examples/basic-lucy-edit-dev.json
  2. 2. Ensure model weights are in the correct directory
  3. 3. Configure ComfyUI settings
  4. 4. Start processing videos locally

Benefits:

  • • Complete data privacy
  • • No internet dependency
  • • Custom configuration
  • • One-time setup

Configuration

Lucy Edit comes with sensible default configurations that work well for most use cases. You can customize these settings based on your specific requirements.

Default Configuration

  • Model: lucy-edit-dev-cui-fp16.safetensors (or fp32 variant)
  • Frame Count: 81 frames for optimal temporal consistency
  • Resolution: Maintains original video resolution
  • Processing: GPU acceleration when available

Workflow Configuration

Lucy Edit workflows can be customized through ComfyUI's node system:

  • • Adjust prompt strength and guidance
  • • Modify frame processing parameters
  • • Configure output format and quality
  • • Set batch processing options

Prompt Guidelines

For best results with Lucy Edit, follow these prompting guidelines and best practices.

Trigger Words

Change

For clothing or color modifications

Add

For adding animals or objects

Replace

For object substitution or subject swap

Transform

For global scene or style transformations

Best Practices

  • • Use 20-30 descriptive words for best results
  • • Include materials, textures, and visual details
  • • Describe lighting, pose, and camera angles
  • • Avoid pronouns like "me/her/him"
  • • Don't mention preservation instructions
  • • Focus on one primary edit at a time

Example Prompts

Clothing Change:

"Change the shirt to a silk kimono with deep indigo dye, wide sleeves, subtle crane pattern, loose fit, soft drape, natural folds, studio lighting, mid-shot, front-facing."

Character Replacement:

"Replace the person with a Bengal tiger, rich orange coat, bold black stripes, fuzzy fur detail, alert ears."

Scene Transformation:

"Transform the scene to early autumn with warm afternoon light, amber tones, a few crisp maple leaves gently falling, shallow depth of field, balanced composition."

Troubleshooting

Common Installation Issues

Issue: Model weights not found
Solution: Ensure weights are placed in ComfyUI/models/diffusion_models/ directory
Issue: CUDA out of memory
Solution: Reduce batch size or use CPU mode for testing
Issue: ComfyUI not recognizing custom node
Solution: Restart ComfyUI after installation and check custom_nodes directory
Issue: Poor edit quality
Solution: Use more descriptive prompts with 20-30 words and appropriate trigger words

Performance Optimization

  • • Use FP16 weights for faster processing and lower memory usage
  • • Process shorter videos (under 30 seconds) for best results
  • • Ensure good lighting and clear subjects in input videos
  • • Use GPU acceleration when available
  • • Monitor memory usage and adjust batch sizes accordingly

Ready to Start Editing?

Now that you have Lucy Edit installed, explore the demo and start transforming your videos.

Try DemoLearn More