docs/GETTING_STARTED.md

Getting Started with WanGP

This guide will help you get started with WanGP video generation quickly and easily.

Prerequisites

Before starting, ensure you have:

• A compatible GPU (RTX 10XX or newer recommended)
• Python 3.10.9 installed
• At least 6GB of VRAM for basic models
• Internet connection for model downloads

Quick Setup

Option 1: One-Click Installation (Recommended)

Use Pinokio App for the easiest installation experience.

Option 2: Manual Installation

git clone https://github.com/deepbeepmeep/Wan2GP.git
cd Wan2GP
conda create -n wan2gp python=3.10.9
conda activate wan2gp
pip install torch==2.6.0 torchvision torchaudio --index-url https://download.pytorch.org/whl/test/cu124
pip install -r requirements.txt

For detailed installation instructions, see INSTALLATION.md.

First Launch

Basic Launch

python wgp.py

This launches the WanGP generator with default settings. You will be able to pick from a Drop Down menu which model you want to use.

Alternative Modes

python wgp.py --i2v        # Wan Image-to-video mode
python wgp.py --t2v-1-3B   # Wan Smaller, faster model

Understanding the Interface

When you launch WanGP, you'll see a web interface with several sections:

Main Generation Panel

• Model Selection: Dropdown to choose between different models
• Prompt: Text description of what you want to generate
• Generate Button: Start the video generation process

Advanced Settings (click checkbox to enable)

• Generation Settings: Steps, guidance, seeds
• Loras: Additional style customizations
• Sliding Window: For longer videos

Your First Video

Let's generate a simple text-to-video:

1. Launch WanGP: python wgp.py
2. Open Browser: Navigate to http://localhost:7860
3. Enter Prompt: "A cat walking in a garden"
4. Click Generate: Wait for the video to be created
5. View Result: The video will appear in the output section

Recommended First Settings

• Model: Wan 2.1 text2video 1.3B (faster, lower VRAM)
• Frames: 49 (about 2 seconds)
• Steps: 20 (good balance of speed/quality)

Model Selection

Text-to-Video Models

• Wan 2.1 T2V 1.3B: Fastest, lowest VRAM (6GB), good quality
• Wan 2.1 T2V 14B: Best quality, requires more VRAM (12GB+)
• Hunyuan Video: Excellent quality, slower generation
• LTX Video: Good for longer videos

Image-to-Video Models

• Wan Fun InP 1.3B: Fast image animation
• Wan Fun InP 14B: Higher quality image animation
• VACE: Advanced control over video generation

Choosing the Right Model

• Low VRAM (6-8GB): Use 1.3B models
• Medium VRAM (10-12GB): Use 14B models or Hunyuan
• High VRAM (16GB+): Any model, longer videos

Basic Settings Explained

Generation Settings

• Frames: Number of frames (more = longer video)

  • 25 frames ≈ 1 second
  • 49 frames ≈ 2 seconds
  • 73 frames ≈ 3 seconds

• Steps: Quality vs Speed tradeoff

  • 15 steps: Fast, lower quality
  • 20 steps: Good balance
  • 30+ steps: High quality, slower

• Guidance Scale: How closely to follow the prompt

  • 3-5: More creative interpretation
  • 7-10: Closer to prompt description
  • 12+: Very literal interpretation

Seeds

• Random Seed: Different result each time
• Fixed Seed: Reproducible results
• Use same seed + prompt: Generate variations

Common Beginner Issues

"Out of Memory" Errors

1. Use smaller models (1.3B instead of 14B)
2. Reduce frame count
3. Lower resolution in advanced settings
4. Enable quantization (usually on by default)

Slow Generation

1. Use 1.3B models for speed
2. Reduce number of steps
3. Install Sage attention (see INSTALLATION.md)
4. Enable TeaCache: python wgp.py --teacache 2.0

Poor Quality Results

1. Increase number of steps (25-30)
2. Improve prompt description
3. Use 14B models if you have enough VRAM
4. Enable Skip Layer Guidance in advanced settings

Writing Good Prompts

Basic Structure

[Subject] [Action] [Setting] [Style/Quality modifiers]

Examples

A red sports car driving through a mountain road at sunset, cinematic, high quality

A woman with long hair walking on a beach, waves in the background, realistic, detailed

A cat sitting on a windowsill watching rain, cozy atmosphere, soft lighting

Tips

• Be specific about what you want
• Include style descriptions (cinematic, realistic, etc.)
• Mention lighting and atmosphere
• Describe the setting in detail
• Use quality modifiers (high quality, detailed, etc.)

Next Steps

Once you're comfortable with basic generation:

1. Explore Advanced Features:

   • Loras Guide - Customize styles and characters
   • VACE ControlNet - Advanced video control
   • Command Line Options - Optimize performance

2. Improve Performance:

   • Install better attention mechanisms
   • Optimize memory settings
   • Use compilation for speed

3. Join the Community:

   • Discord Server - Get help and share videos
   • Share your best results
   • Learn from other users

Troubleshooting First Steps

Installation Issues

• Ensure Python 3.10.9 is used
• Check CUDA version compatibility
• See INSTALLATION.md for detailed steps

Generation Issues

• Check GPU compatibility
• Verify sufficient VRAM
• Try basic settings first
• See TROUBLESHOOTING.md for specific issues

Performance Issues

• Use appropriate model for your hardware
• Enable performance optimizations
• Check CLI.md for optimization flags

Remember: Start simple and gradually explore more advanced features as you become comfortable with the basics!