Lucy Edit: AI-Powered Video Editing with Text Prompts

Lucy Edit is a video editing model that performs instruction-guided edits on videos using free-text prompts. Change clothing, replace characters, add objects, and transform scenes while preserving motion and composition perfectly.

Key Features

Motion Preservation

Preserves the motion and composition of videos perfectly, allowing precise edits without disrupting the original flow and timing of the content.

Edit Reliability

Edits are more robust when compared to common inference time methods, providing consistent and reliable results across different video types and scenarios.

Pure Text Instructions

No fine-tuning or masks required for common edits. Simply describe what you want to change using natural language prompts.

Supported Edit Types

Clothing Changes

Best performance. Lucy Edit excels at swapping outfits while preserving motion, pose, and identity.

Example: "Change the shirt to a kimono with wide sleeves and patterned fabric."

Character Replacement

Strong results. Works well for transforming people into new characters or creatures. Detailed prompts are key.

Example: "Replace the person with a tiger, striped orange fur, muscular build, and glowing green eyes."

Object Replacement

Reliable for structure-preserving swaps. Ideal when replacing one object with another of similar scale.

Example: "Replace the apple with a glowing crystal ball emitting blue light."

Color Changes

Mixed reliability. Sometimes subtle, sometimes exaggerated. Works best with precise descriptions.

Example: "Change the jacket color to deep red leather with a glossy finish."

Add Objects

Often attaches to the subject. Works best for wearable or handheld props.

Example: "Add a golden crown on the person's head, decorated with ornate jewels."

Global Transformations

Effective for backgrounds or scene-wide changes, might alter the subject. Often changes the identity of the subject.

Example: "Transform the sunny beach into a snowy tundra with falling snowflakes."

Installation Guide

Quick Setup

Step 1: Clone Repository

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

Step 2: Install Dependencies

pip install -r requirements.txt

Step 3: Download Model Weights

Choose the appropriate weights for your setup:

FP16 Weights (Recommended)

Smaller file size, faster processing

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

Higher precision, larger file size

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

Place the downloaded weights under: models/diffusion_models/

Usage Options

Lucy Edit Pro (API)

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

  • • Load the workflow from examples/basic-api-lucy-edit.json
  • • Get an API key from platform.decart.ai
  • • No local setup required
  • • Scalable cloud processing

Lucy Edit Dev (Local)

Run Lucy Edit locally for complete control and privacy.

  • • Load the workflow from examples/basic-lucy-edit-dev.json
  • • Full local processing
  • • No internet required after setup
  • • Complete data privacy
Setup Guide →

Try Lucy Edit

Experience Lucy Edit in action. Upload a video and describe the changes you want to make using natural language.

Prompting Guidelines

Lucy Edit is built for precise, realistic, and identity-preserving video edits. Prompts with 20-30 descriptive words work best. Using the right trigger words helps the model understand your intent.

Trigger Words

  • Change → Clothing or color modifications
  • Add → Adding animals or objects
  • Replace → Object substitution or subject swap
  • Transform to → 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

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."

Technical Specifications

Performance

  • • 81-frame generations for better temporal consistency
  • • Identity conservation and edit precision
  • • Realistic results with strong prompt adherence
  • • Motion preservation across all edit types

Compatibility

  • • ComfyUI integration for workflow management
  • • Hugging Face Spaces for easy testing
  • • API access for production applications
  • • Local deployment for privacy-sensitive use cases

Use Cases

Content Creation

Transform videos for social media, marketing, and entertainment content with simple text prompts.

Film Production

Make quick costume changes, character swaps, and scene modifications during post-production.

Education

Create educational content with character replacements and scene transformations for better engagement.

Prototyping

Quickly prototype video concepts and test different visual approaches before final production.

Frequently Asked Questions

What makes Lucy Edit different from other video editing tools?

Lucy Edit uses AI to understand natural language prompts and automatically applies edits while preserving motion and composition. Unlike traditional video editing software, you don't need to manually select regions or create masks - just describe what you want to change in plain English.

What types of videos work best with Lucy Edit?

Lucy Edit works best with videos that have clear subjects and good lighting. It excels at editing people in various poses and clothing, but can also work with objects and scenes. The model performs best with videos that have consistent motion and composition throughout the clip.

How long does it take to process a video?

Processing time depends on the length of your video and the complexity of the edit. Generally, shorter videos (under 10 seconds) process faster. The API version typically processes videos in a few minutes, while local processing depends on your hardware specifications.

Can I edit multiple things in one video?

Yes, you can make multiple edits in a single prompt. For example, you could say "Change the shirt to a red t-shirt and add sunglasses to the person." However, complex multi-edit prompts may be less reliable than focusing on one primary edit at a time.

What file formats are supported?

Lucy Edit supports common video formats including MP4, AVI, MOV, and others. The output is typically provided in MP4 format. For best results, use videos with good resolution (720p or higher) and clear visual quality.

Is there a limit on video length?

While there's no strict limit, Lucy Edit works best with shorter videos (under 30 seconds). Longer videos may take more time to process and could have reduced quality in the final output. For longer content, consider breaking it into smaller segments.

Can I use Lucy Edit commercially?

Yes, Lucy Edit can be used for commercial purposes. The model is designed to support various use cases including content creation, marketing, and entertainment. Check the specific licensing terms for your chosen deployment method (API vs local) for any restrictions.

How do I get the best results from Lucy Edit?

For best results, use detailed prompts with 20-30 words describing the specific changes you want. Include details about materials, textures, colors, and visual style. Use the appropriate trigger words (Change, Add, Replace, Transform) and avoid vague descriptions. Test with shorter videos first to understand how the model interprets your prompts.