Skip to content
Python

Merge branch 'main' into better_Readme

deepbeepmeep263bef944e07
diff --cc README.md
index d9c74e9,ea24df7..1158458
--- a/README.md
+++ b/README.md
@@@ -15,44 -15,144 +15,44 @@@ WanGP supports the Wan (and derived mod
- Loras Support to customize each model
- Queuing system : make your shopping list of videos to generate and come back later
-
**Discord Server to get Help from Other Users and show your Best Videos:** https://discord.gg/g7efUW9jGV
+## πŸ”₯ Latest Updates
++### May 28 2025: WanGP v5.31
++πŸ‘‹ Added Phantom 14B, a model that you can use to transfer objects / people in the video. My preference goes to Vace that remains the king of controlnets.
++VACE improvements: Better sliding window transitions, image mask support in Matanyone, new Extend Video feature, and enhanced background removal options.
- ### May 26, 2025: Wan 2.1GP v5.3
++### May 26, 2025: WanGP v5.3
+πŸ‘‹ Settings management revolution! Now you can:
+- Select any generated video and click *Use Selected Video Settings* to instantly reuse its configuration
+- Drag & drop videos to automatically extract their settings metadata
+- Export/import settings as JSON files for easy sharing and backup
- ### May 23, 2025: Wan 2.1GP v5.21
- πŸ‘‹ VACE improvements: Better sliding window transitions, image mask support in Matanyone, new Extend Video feature, and enhanced background removal options.
-## πŸ”₯ Latest News!!
-* May 26 2025: πŸ‘‹ WanGP v5.31 : Added Phantom 14B, a model that you can use to transfer objects / people in the video. My preference goes to Vace that remains the king of controlnets.
-* May 26 2025: πŸ‘‹ WanGP v5.3 : Happy with a Video generation and want to do more generations using the same settings but you can't remember what you did or you find it to hard to copy / paste one per one each setting from the file metadata ? Rejoice ! There are now multiple ways to turn this tedious process into a one click task:
- - Select one Video recently generated in the Video Gallery and click *Use Selected Video Settings*
- - Click *Drop File Here* and select a Video you saved somewhere, if the settings metadata have been saved with the Video you will be able to extract them automatically
- - Click *Export Settings to File* to save on your harddrive the current settings. You will be able to use them later again by clicking *Drop File Here* and select this time a Settings json file
-* May 23 2025: πŸ‘‹ WanGP v5.21 : Improvements for Vace: better transitions between Sliding Windows,Support for Image masks in Matanyone, new Extend Video for Vace, different types of automated background removal
-* May 20 2025: πŸ‘‹ WanGP v5.2 : Added support for Wan CausVid which is a distilled Wan model that can generate nice looking videos in only 4 to 12 steps.
- The great thing is that Kijai (Kudos to him !) has created a CausVid Lora that can be combined with any existing Wan t2v model 14B like Wan Vace 14B.
- See instructions below on how to use CausVid.\
- Also as an experiment I have added support for the MoviiGen, the first model that claims to capable to generate 1080p videos (if you have enough VRAM (20GB...) and be ready to wait for a long time...). Don't hesitate to share your impressions on the Discord server.
-* May 18 2025: πŸ‘‹ WanGP v5.1 : Bonus Day, added LTX Video 13B Distilled: generate in less than one minute, very high quality Videos !
-* May 17 2025: πŸ‘‹ WanGP v5.0 : One App to Rule Them All !\
- Added support for the other great open source architectures:
- - Hunyuan Video : text 2 video (one of the best, if not the best t2v) ,image 2 video and the recently released Hunyuan Custom (very good identify preservation when injecting a person into a video)
- - LTX Video 13B (released last week): very long video support and fast 720p generation.Wan GP version has been greatly optimzed and reduced LTX Video VRAM requirements by 4 !
--
- ### May 20, 2025: Wan 2.1GP v5.2
- Also:
- - Added supported for the best Control Video Model, released 2 days ago : Vace 14B
- - New Integrated prompt enhancer to increase the quality of the generated videos
- You will need one more *pip install -r requirements.txt*
-
-* May 5 2025: πŸ‘‹ WanGP v4.5: FantasySpeaking model, you can animate a talking head using a voice track. This works not only on people but also on objects. Also better seamless transitions between Vace sliding windows for very long videos (see recommended settings). New high quality processing features (mixed 16/32 bits calculation and 32 bitsVAE)
-* April 27 2025: πŸ‘‹ WanGP v4.4: Phantom model support, very good model to transfer people or objects into video, works quite well at 720p and with the number of steps > 30
-* April 25 2025: πŸ‘‹ WanGP v4.3: Added preview mode and support for Sky Reels v2 Diffusion Forcing for high quality "infinite length videos" (see Window Sliding section below).Note that Skyreel uses causal attention that is only supported by Sdpa attention so even if chose an other type of attention, some of the processes will use Sdpa attention.
-
-* April 18 2025: πŸ‘‹ WanGP v4.2: FLF2V model support, official support from Wan for image2video start and end frames specialized for 720p.
-* April 17 2025: πŸ‘‹ WanGP v4.1: Recam Master model support, view a video from a different angle. The video to process must be at least 81 frames long and you should set at least 15 steps denoising to get good results.
-* April 13 2025: πŸ‘‹ WanGP v4.0: lots of goodies for you !
- - A new UI, tabs were replaced by a Dropdown box to easily switch models
- - A new queuing system that lets you stack in a queue as many text2video, imag2video tasks, ... as you want. Each task can rely on complete different generation parameters (different number of frames, steps, loras, ...). Many thanks to **Tophness** for being a big contributor on this new feature
- - Temporal upsampling (Rife) and spatial upsampling (Lanczos) for a smoother video (32 fps or 64 fps) and to enlarge your video by x2 or x4. Check these new advanced options.
- - Wan Vace Control Net support : with Vace you can inject in the scene people or objects, animate a person, perform inpainting or outpainting, continue a video, ... I have provided an introduction guide below.
- - Integrated *Matanyone* tool directly inside WanGP so that you can create easily inpainting masks used in Vace
- - Sliding Window generation for Vace, create windows that can last dozen of seconds
- - New optimisations for old generation GPUs: Generate 5s (81 frames, 15 steps) of Vace 1.3B with only 5GB and in only 6 minutes on a RTX 2080Ti and 5s of t2v 14B in less than 10 minutes.
-
-* Mar 27 2025: πŸ‘‹ Added support for the new Wan Fun InP models (image2video). The 14B Fun InP has probably better end image support but unfortunately existing loras do not work so well with it. The great novelty is the Fun InP image2 1.3B model : Image 2 Video is now accessible to even lower hardware configuration. It is not as good as the 14B models but very impressive for its size. You can choose any of those models in the Configuration tab. Many thanks to the VideoX-Fun team (https://github.com/aigc-apps/VideoX-Fun)
-* Mar 26 2025: πŸ‘‹ Good news ! Official support for RTX 50xx please check the installation instructions below.
-* Mar 24 2025: πŸ‘‹ Wan2.1GP v3.2:
- - Added Classifier-Free Guidance Zero Star. The video should match better the text prompt (especially with text2video) at no performance cost: many thanks to the **CFG Zero * Team:**\
- Dont hesitate to give them a star if you appreciate the results: https://github.com/WeichenFan/CFG-Zero-star
- - Added back support for Pytorch compilation with Loras. It seems it had been broken for some time
- - Added possibility to keep a number of pregenerated videos in the Video Gallery (useful to compare outputs of different settings)
- You will need one more *pip install -r requirements.txt*
-* Mar 19 2025: πŸ‘‹ Wan2.1GP v3.1: Faster launch and RAM optimizations (should require less RAM to run)\
- You will need one more *pip install -r requirements.txt*
-* Mar 18 2025: πŸ‘‹ Wan2.1GP v3.0:
- - New Tab based interface, yon can switch from i2v to t2v conversely without restarting the app
- - Experimental Dual Frames mode for i2v, you can also specify an End frame. It doesn't always work, so you will need a few attempts.
- - You can save default settings in the files *i2v_settings.json* and *t2v_settings.json* that will be used when launching the app (you can also specify the path to different settings files)
- - Slight acceleration with loras\
- You will need one more *pip install -r requirements.txt*
- Many thanks to *Tophness* who created the framework (and did a big part of the work) of the multitabs and saved settings features
-* Mar 18 2025: πŸ‘‹ Wan2.1GP v2.11: Added more command line parameters to prefill the generation settings + customizable output directory and choice of type of metadata for generated videos. Many thanks to *Tophness* for his contributions. You will need one more *pip install -r requirements.txt* to reflect new dependencies\
-* Mar 18 2025: πŸ‘‹ Wan2.1GP v2.1: More Loras !: added support for 'Safetensors' and 'Replicate' Lora formats.\
-You will need to refresh the requirements with a *pip install -r requirements.txt*
-* Mar 17 2025: πŸ‘‹ Wan2.1GP v2.0: The Lora festival continues:
- - Clearer user interface
- - Download 30 Loras in one click to try them all (expand the info section)
- - Very to use Loras as now Lora presets can input the subject (or other need terms) of the Lora so that you dont have to modify manually a prompt
- - Added basic macro prompt language to prefill prompts with differnent values. With one prompt template, you can generate multiple prompts.
- - New Multiple images prompts: you can now combine any number of images with any number of text promtps (need to launch the app with --multiple-images)
- - New command lines options to launch directly the 1.3B t2v model or the 14B t2v model
-* Mar 14, 2025: πŸ‘‹ Wan2.1GP v1.7:
- - Lora Fest special edition: very fast loading / unload of loras for those Loras collectors around. You can also now add / remove loras in the Lora folder without restarting the app. You will need to refresh the requirements *pip install -r requirements.txt*
- - Added experimental Skip Layer Guidance (advanced settings), that should improve the image quality at no extra cost. Many thanks to the *AmericanPresidentJimmyCarter* for the original implementation
-* Mar 13, 2025: πŸ‘‹ Wan2.1GP v1.6: Better Loras support, accelerated loading Loras. You will need to refresh the requirements *pip install -r requirements.txt*
-* Mar 10, 2025: πŸ‘‹ Wan2.1GP v1.5: Official Teacache support + Smart Teacache (find automatically best parameters for a requested speed multiplier), 10% speed boost with no quality loss, improved lora presets (they can now include prompts and comments to guide the user)
-* Mar 07, 2025: πŸ‘‹ Wan2.1GP v1.4: Fix Pytorch compilation, now it is really 20% faster when activated
-* Mar 04, 2025: πŸ‘‹ Wan2.1GP v1.3: Support for Image to Video with multiples images for different images / prompts combinations (requires *--multiple-images* switch), and added command line *--preload x* to preload in VRAM x MB of the main diffusion model if you find there is too much unused VRAM and you want to (slightly) accelerate the generation process.
-If you upgrade you will need to do a 'pip install -r requirements.txt' again.
-* Mar 04, 2025: πŸ‘‹ Wan2.1GP v1.2: Implemented tiling on VAE encoding and decoding. No more VRAM peaks at the beginning and at the end
-* Mar 03, 2025: πŸ‘‹ Wan2.1GP v1.1: added Tea Cache support for faster generations: optimization of kijai's implementation (https://github.com/kijai/ComfyUI-WanVideoWrapper/) of teacache (https://github.com/ali-vilab/TeaCache)
-* Mar 02, 2025: πŸ‘‹ Wan2.1GP by DeepBeepMeep v1 brings:
- - Support for all Wan including the Image to Video model
- - Reduced memory consumption by 2, with possiblity to generate more than 10s of video at 720p with a RTX 4090 and 10s of video at 480p with less than 12GB of VRAM. Many thanks to REFLEx (https://github.com/thu-ml/RIFLEx) for their algorithm that allows generating nice looking video longer than 5s.
- - The usual perks: web interface, multiple generations, loras support, sage attebtion, auto download of models, ...
-
-* Feb 25, 2025: πŸ‘‹ We've released the inference code and weights of Wan2.1.
-* Feb 27, 2025: πŸ‘‹ Wan2.1 has been integrated into [ComfyUI](https://comfyanonymous.github.io/ComfyUI_examples/wan/). Enjoy!
-
-
-
-## Installation Guide for Linux and Windows for GPUs up to RTX40xx
-
-**If you are looking for a one click installation, just go to the Pinokio App store : https://pinokio.computer/**\
-Otherwise you will find the instructions below:
-
-This app has been tested on Python 3.10 / 2.6.0 / Cuda 12.4.
-
-```shell
-# 0 Download the source and create a Python 3.10.9 environment using conda or create a venv using python
-git clone https://github.com/deepbeepmeep/Wan2GP.git
-cd Wan2GP
-conda create -n wan2gp python=3.10.9
-conda activate wan2gp
-
-# 1 Install pytorch 2.6.0
-pip install torch==2.6.0 torchvision torchaudio --index-url https://download.pytorch.org/whl/test/cu124
++### May 20, 2025: WanGP v5.2
+πŸ‘‹ **CausVid support** - Generate videos in just 4-12 steps with the new distilled Wan model! Also added experimental MoviiGen for 1080p generation (20GB+ VRAM required).
- ### May 18, 2025: Wan 2.1GP v5.1
-# 2. Install pip dependencies
-pip install -r requirements.txt
++### May 18, 2025: WanGP v5.1
+πŸ‘‹ **LTX Video 13B Distilled** - Generate high-quality videos in less than one minute!
- ### May 17, 2025: Wan 2.1GP v5.0
-# 3.1 optional Sage attention support (30% faster)
-# Windows only: extra step only needed for windows as triton is included in pytorch with the Linux version of pytorch
-pip install triton-windows
-# For both Windows and Linux
-pip install sageattention==1.0.6
++### May 17, 2025: WanGP v5.0
+πŸ‘‹ **One App to Rule Them All!** Added Hunyuan Video and LTX Video support, plus Vace 14B and integrated prompt enhancer.
+See full changelog: **[Changelog](docs/CHANGELOG.md)**
-# 3.2 optional Sage 2 attention support (40% faster)
-# Windows only
-pip install triton-windows
-pip install https://github.com/woct0rdho/SageAttention/releases/download/v2.1.1-windows/sageattention-2.1.1+cu126torch2.6.0-cp310-cp310-win_amd64.whl
-# Linux only (sorry only manual compilation for the moment, but is straight forward with Linux)
-git clone https://github.com/thu-ml/SageAttention
-cd SageAttention
-pip install -e .
+## πŸ“‹ Table of Contents
-# 3.3 optional Flash attention support (easy to install on Linux but may be complex on Windows as it will try to compile the cuda kernels)
-pip install flash-attn==2.7.2.post1
+- [πŸš€ Quick Start](#-quick-start)
+- [πŸ“¦ Installation](#-installation)
+- [🎯 Usage](#-usage)
+- [πŸ“š Documentation](#-documentation)
+- [πŸ”— Related Projects](#-related-projects)
-```
+## πŸš€ Quick Start
-Note pytorch *sdpa attention* is available by default. It is worth installing *Sage attention* (albout not as simple as it sounds) because it offers a 30% speed boost over *sdpa attention* at a small quality cost.
-In order to install Sage, you will need to install also Triton. If Triton is installed you can turn on *Pytorch Compilation* which will give you an additional 20% speed boost and reduced VRAM consumption.
+**One-click installation:** Get started instantly with [Pinokio App](https://pinokio.computer/)
-## Installation Guide for Linux and Windows for GPUs up to RTX50xx
-RTX50XX are only supported by pytorch starting from pytorch 2.7.0 which is still in beta. Therefore this version may be less stable.\
-It is important to use Python 3.10 otherwise the pip wheels may not be compatible.
-```
-# 0 Download the source and create a Python 3.10.9 environment using conda or create a venv using python
+**Manual installation:**
+```bash
git clone https://github.com/deepbeepmeep/Wan2GP.git
cd Wan2GP
conda create -n wan2gp python=3.10.9