Setup guide
Video Gen Link
Wan2GP Wan2GP (also called WanGP) is an open-source AI video generator. It lets you create videos from text prompts and images using models like Wan, Hunyuan Video, LTX Video, Flux, Qwen, and more. It runs locally on your
Wan2GP | AI Video Generator Setup Guide
Wan2GP
AI Video Generator | Setup Guide
What Is Wan2GP?
Wan2GP (also called WanGP) is an open-source AI video generator. It lets you create videos from text prompts and images using models like Wan, Hunyuan Video, LTX Video, Flux, Qwen, and more. It runs locally on your computer and provides a full web-based interface.
Method 1: Easy One-Click Install (Recommended)
Download or clone the project from
https://github.com/deepbeepmeep/Wan2GP
Open the scripts folder and run the appropriate file for your OS
Windows
scripts\install.bat
Linux / macOS
scripts/install.sh When prompted, choose Auto Install and wait for it to finish. It sets up the Python environment, all dependencies, and required packages automatically.
Method 2: Pinokio Install (No Terminal Required)
Download Pinokio from
https://pinokio.computer Open Pinokio, search for wan2gp or wan2gp-amd, install the community script, and launch Wan2GP directly. No terminal commands needed.
Method 3: Manual Install
Install Conda or Miniconda first, then open your terminal and run
git clone https://github.com/deepbeepmeep/Wan2GP.git
cd Wan2GP
conda create -n wan2gp python=3.11.14 conda activate wan2gp
pip install torch==2.10.0 torchvision torchaudio \
–index-url https://download.pytorch.org/whl/cu130
pip install -r requirements.txt
python wgp.py
Page 1 | github.com/deepbeepmeep/Wan2GP
Wan2GP | AI Video Generator Setup Guide
Then open your browser and go to: http://localhost:7860
How To Launch After Installation
One-click installer (Windows)
scripts\run.bat
One-click installer (Linux / macOS)
scripts/run.sh
Manual installation
conda activate wan2gp
cd Wan2GP
python wgp.py
# Then open: http://localhost:7860
How To Update Wan2GP
Manual installation – run from inside the Wan2GP folder
git pull
conda activate wan2gp
pip install -r requirements.txt
One-click scripts
scripts\update.bat (Windows)
scripts/update.sh (Linux / macOS)
Pinokio users: update from inside the Pinokio app.
How To Generate Your First Video
- Open Wan2GP in your browser
- Choose a model from the model dropdown
- Enter a text prompt
- Choose basic settings
- Click Generate
- Wait for the video to finish rendering
- Download or preview from the output section
Example prompt
A cinematic shot of a red sports car driving through a mountain road at sunset, realistic, high quality
Page 2 | github.com/deepbeepmeep/Wan2GP
Wan2GP | AI Video Generator Setup Guide
Recommended First Settings
BEGINNER SETTINGS
Model: Wan 2.1 Text-to-Video 1.3B | Frames: 49 | Steps: 20 The 1.3B model is fast, 49 frames gives ~2 seconds of video, 20 steps balances speed and quality.
Good Prompt Format
Structure: Subject + Action + Location + Style
A woman walking on a beach during sunset, cinematic, realistic, soft lighting A cat sitting near a window while rain falls outside, cozy atmosphere, detailed A futuristic city at night with flying cars, neon lights, cinematic camera movement
Common Problems and Fixes
Problem: Out of memory error
Fix: Use a smaller model, reduce frames or resolution, or switch to the 1.3B model.
Problem: Video generation is slow
Fix: Use fewer steps, smaller models, lower resolution, or generate shorter videos.
Problem: Poor video quality
Fix: Improve your prompt, increase steps to 25-30, and add keywords like: cinematic, realistic, detailed, high quality.
How It Works
Wan2GP runs as a local web app on your machine. The full flow
You type a prompt in the browser
-> Wan2GP loads the selected model
-> The model generates the video -> Output appears in the browser -> You download or preview the result
Best Beginner Workflow
- Install using the one-click script or Pinokio
- Launch Wan2GP and open http://localhost:7860
- Select the 1.3B model first
- Generate a short 2-second video (49 frames, 20 steps)
- Test different prompts
Page 3 | github.com/deepbeepmeep/Wan2GP
Wan2GP | AI Video Generator Setup Guide
- Increase quality settings only after everything works
- Try image-to-video after learning text-to-video
Useful Links
GitHub: https://github.com/deepbeepmeep/Wan2GP
Pinokio: https://pinokio.computer
Page 4 | github.com/deepbeepmeep/Wan2GP
Final checklist
- The required app, command, or service opens correctly.
- Credentials are stored outside public files and screenshots.
- A small test run completes before you use the setup for real work.
- You know where logs, output files, and error messages are stored.