Instructions to use geceff/Wan2.2-Custom-Models-GGUF with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- Wan2.2
How to use geceff/Wan2.2-Custom-Models-GGUF with Wan2.2:
# No code snippets available yet for this library. # To use this model, check the repository files and the library's documentation. # Want to help? PRs adding snippets are welcome at: # https://github.com/huggingface/huggingface.js
- Notebooks
- Google Colab
- Kaggle
Update README.md
Browse files
README.md
CHANGED
|
@@ -21,7 +21,7 @@ This repository provides highly optimized **Wan2.2 Image-to-Video (I2V) GGUF** a
|
|
| 21 |
---
|
| 22 |
|
| 23 |
## โ ๏ธ CRITICAL NOTICE: UN-UPDATED BASE MODEL WARNING
|
| 24 |
-
* ๐จ **Full-Size Base Models:** Please note that the full-size raw models and non-quantized base files **have
|
| 25 |
* ๐ก **Current Availability:** Only the custom-compiled quants (GGUF), specialized LoRAs, Text Encoders (`umt5_xxl_fp16 - umt5_xxl_fp8_e4m3fn_scaled`), VAEs (`Wan2_1_VAE_fp32` / `wan_2.1_bf16`), and specific FP8 integrated models are fully active and optimized for deployment. If you require raw unquantized BF16 weights, please wait for future repository syncs or utilize the available GGUF variants.
|
| 26 |
|
| 27 |
---
|
|
@@ -33,8 +33,8 @@ To achieve perfect video motion without artifacts or image degradation (preventi
|
|
| 33 |
| Parameter | Recommended Value | Note |
|
| 34 |
| :--- | :--- | :--- |
|
| 35 |
| **Total Sampling Steps** | `4 - 12` | Absolute maximum ceiling is **12 total steps** for Lightning / Distilled V2 |
|
| 36 |
-
| **CFG Scale** | `1.0 - 2
|
| 37 |
-
| **High Noise Steps** | `2`, `4`, `6`, or `8` | To lock in strong motion. Can be split evenly (e.g., 8 steps total = 4 High / 4 Low) |
|
| 38 |
| **Low Noise Steps** | *Dynamic* (End Step: `4 - 12`) | **CRITICAL:** The target End Step for Low Noise must **NEVER** exceed the Total Sampling Steps! |
|
| 39 |
| **Sampler / Scheduler** | `euler` + `simple` | Standard diffusion setup (Optionally, `uni_pc` can also be used for alternative fast-stepping) |
|
| 40 |
|
|
@@ -55,16 +55,16 @@ However, due to severe hardware VRAM limitations and Web GUI overhead, you **MUS
|
|
| 55 |
#### ๐ 2. Via Backdoor (Direct Code / Colab Forms Setup)
|
| 56 |
* ๐ฅ **NVIDIA Tesla T4 (15GB VRAM - Unlocking Full Potential):** By executing via the backend script directly, you bypass the heavy Web GUI memory overhead entirely, allowing you to forcefully squeeze maximum performance out of your T4 GPU!
|
| 57 |
* **The T4 Backdoor Formulas:**
|
| 58 |
-
* **Ultimate Quality Setup:** You can successfully execute the top-tier hybrid workflow: **`
|
| 59 |
-
* **Pro Option for Speed:** If you want faster generation times with a minor trade-off, switch to **`
|
| 60 |
|
| 61 |
---
|
| 62 |
|
| 63 |
-
## ๐พ Available Model Variants & Architecture
|
| 64 |
|
| 65 |
Choose the right variant based on your creative workflow and VRAM configuration. All files are organized into dedicated subdirectories for pipeline flexibility:
|
| 66 |
|
| 67 |
-
### ๐ญ 1. Specialized Integrated FP8 Models (`/diffusion_models`)
|
| 68 |
These models feature pre-baked pipelines integrated with **SVI (Stable Video Infinity)** for continuous video synthesis and **Consistent Face** weights to prevent character distortion across frames.
|
| 69 |
* **`Wan2_2-I2V-A14B-HIGH_SVI_consistent_face_nsfw_fp8.safetensors`**: Structural expert optimized for initial motion pathways, camera dynamics, and uncensored/free-form pipeline generations.
|
| 70 |
* **`Wan2_2-I2V-A14B-LOW_SVI_consistent_face_nsfw_fp8.safetensors`**: Fine-tuning expert optimized for character preservation, facial structural lock, and detailed refinement.
|
|
|
|
| 21 |
---
|
| 22 |
|
| 23 |
## โ ๏ธ CRITICAL NOTICE: UN-UPDATED BASE MODEL WARNING
|
| 24 |
+
* ๐จ **Full-Size Base Models:** Please note that the full-size raw models and non-quantized base files **have NOW been updated ** in this repository.
|
| 25 |
* ๐ก **Current Availability:** Only the custom-compiled quants (GGUF), specialized LoRAs, Text Encoders (`umt5_xxl_fp16 - umt5_xxl_fp8_e4m3fn_scaled`), VAEs (`Wan2_1_VAE_fp32` / `wan_2.1_bf16`), and specific FP8 integrated models are fully active and optimized for deployment. If you require raw unquantized BF16 weights, please wait for future repository syncs or utilize the available GGUF variants.
|
| 26 |
|
| 27 |
---
|
|
|
|
| 33 |
| Parameter | Recommended Value | Note |
|
| 34 |
| :--- | :--- | :--- |
|
| 35 |
| **Total Sampling Steps** | `4 - 12` | Absolute maximum ceiling is **12 total steps** for Lightning / Distilled V2 |
|
| 36 |
+
| **CFG Scale** | `1.0 - 2` | Crucial for preventing burnt images |
|
| 37 |
+
| **High Noise Steps** | `2`, `4`, `6`, or `8` | To lock in strong motion. Can be split evenly (e.g., 8 steps total = 4 High / 4 Low) or 6 step total = 3 High / 3 low |
|
| 38 |
| **Low Noise Steps** | *Dynamic* (End Step: `4 - 12`) | **CRITICAL:** The target End Step for Low Noise must **NEVER** exceed the Total Sampling Steps! |
|
| 39 |
| **Sampler / Scheduler** | `euler` + `simple` | Standard diffusion setup (Optionally, `uni_pc` can also be used for alternative fast-stepping) |
|
| 40 |
|
|
|
|
| 55 |
#### ๐ 2. Via Backdoor (Direct Code / Colab Forms Setup)
|
| 56 |
* ๐ฅ **NVIDIA Tesla T4 (15GB VRAM - Unlocking Full Potential):** By executing via the backend script directly, you bypass the heavy Web GUI memory overhead entirely, allowing you to forcefully squeeze maximum performance out of your T4 GPU!
|
| 57 |
* **The T4 Backdoor Formulas:**
|
| 58 |
+
* **Ultimate Quality Setup:** You can successfully execute the top-tier hybrid workflow: **`Q4K_M` (High Noise) + `Q4K_M` (Low Noise)**.
|
| 59 |
+
* **Pro Option for Speed:** If you want faster generation times with a minor trade-off, switch to **`Q4_K` (High Noise) + `Q6_K` (Low Noise)** or **`Q4K_M.gguf` (High Noise) + `Q4K_M` (Low Noise)**. This delivers optimized speed while maintaining excellent visual quality compared to full high-quants.
|
| 60 |
|
| 61 |
---
|
| 62 |
|
| 63 |
+
## ๐พ Available Model Variants & Architecture.Reccomend onL4S or L4(slowly and short length totalfeame) or higher
|
| 64 |
|
| 65 |
Choose the right variant based on your creative workflow and VRAM configuration. All files are organized into dedicated subdirectories for pipeline flexibility:
|
| 66 |
|
| 67 |
+
### ๐ญ 1. Reccomend on L4S or higher Specialized Integrated FP8 Models (`/diffusion_models`)
|
| 68 |
These models feature pre-baked pipelines integrated with **SVI (Stable Video Infinity)** for continuous video synthesis and **Consistent Face** weights to prevent character distortion across frames.
|
| 69 |
* **`Wan2_2-I2V-A14B-HIGH_SVI_consistent_face_nsfw_fp8.safetensors`**: Structural expert optimized for initial motion pathways, camera dynamics, and uncensored/free-form pipeline generations.
|
| 70 |
* **`Wan2_2-I2V-A14B-LOW_SVI_consistent_face_nsfw_fp8.safetensors`**: Fine-tuning expert optimized for character preservation, facial structural lock, and detailed refinement.
|