Wan2.2-Custom-Models-GGUF

Wan2.2 Custom GGUF & Specialized Models (Tesla T4 Optimized)

This repository provides highly optimized Wan2.2 Image-to-Video (I2V) GGUF and specialized custom models. These variants are tailored for running efficiently on memory-constrained environments, such as Google Colab equipped with an NVIDIA Tesla T4 GPU, while offering professional-grade motion extensions.

---

⚠️ CRITICAL NOTICE: UN-UPDATED BASE MODEL WARNING

• 🚨 Full-Size Base Models: Please note that the full-size raw models and non-quantized base files have NOT been updated yet in this repository.
• 💡 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.

---

⚡ Optimal Settings for ComfyUI

To achieve perfect video motion without artifacts or image degradation (preventing fried, burnt, or oversaturated visuals), we strongly recommend using the following parameters:

👑 Note for Higher Quality (Hybrid Workflow & Hardware Restrictions):

If you want to achieve higher visual fidelity and enhance micro-details, adopting a hybrid multi-pass approach is highly recommended. This strategy significantly sharpens fine details, effectively eliminates motion blur, and prevents fried visuals.

However, due to severe hardware VRAM limitations and Web GUI overhead, you MUST strictly adhere to the following setup configurations based on your execution environment:

💻 1. Via ComfyUI GUI (Web Interface Setup)

• 🟢 NVIDIA L4 (24GB VRAM) or higher: You can comfortably run high-tier configurations via the Web GUI with these setup options:
  • Standard High-Quality Setup: Use Q8_H (High Noise) + Q8_H (Low Noise) GGUF files.
  • Maximum Fidelity Option: Use Q8_H (High Noise) and chain it with wan2.2_i2v_low_noise_14B_fp8_scaled.safetensors as the final step to achieve ultimate sharpness and micro-details.
• ⚠️ NVIDIA Tesla T4 (15GB VRAM - Free Tier GUI Limits): DO NOT use any models inside the /diffusion_models folder, nor any external FP8 models placed outside in the root directory! Because the Web GUI consumes a massive amount of VRAM just to render its interface, available memory is extremely critical. Forcing these models via GUI will trigger an immediate OOM (Out of Memory) crash.
  • 📏 Resolution Restrictions: Video dimensions must NOT exceed 480P in height (Max 480px) and NOT exceed 720P in width (Max 720px).
  • 🛑 Frame Limit: To remain stable, your generation length MUST NOT exceed 81-120(T4) frames max.
  • 🛡️ Safe GUI Quantization Range: Your setup configurations via Web GUI are strictly restricted within the Q4_K_M to Q8_H range for both High Noise and Low Noise GGUF models.

🚀 2. Via Backdoor (Direct Code / Colab Forms Setup)

• 🔥 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!
• The T4 Backdoor Formulas:
  • Ultimate Quality Setup: You can successfully execute the top-tier hybrid workflow: Q8_H (High Noise) + Q8_H (Low Noise).
  • Pro Option for Speed: If you want faster generation times with a minor trade-off, switch to Q6_K (High Noise) + Q6_K (Low Noise) or Q6_K (High Noise) + Q8_H (Low Noise). This delivers optimized speed while maintaining excellent visual quality compared to full high-quants.

---

💾 Available Model Variants & Architecture

Choose the right variant based on your creative workflow and VRAM configuration. All files are organized into dedicated subdirectories for pipeline flexibility:

🎭 1. Specialized Integrated FP8 Models (/diffusion_models)

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.

• 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.
• Wan2_2-I2V-A14B-LOW_SVI_consistent_face_nsfw_fp8.safetensors: Fine-tuning expert optimized for character preservation, facial structural lock, and detailed refinement.

⚡ 2. Quantized Diffusion Models (Root Directory GGUF)

• High Noise Quantizations (wan2.2_i2v_high_noise_14B_...): Best for creative, high-motion generation, and diverse camera movements. Available in: Q4_K_M, Q6_K_L, Q6_K, Q8_H, and fp8_scaled.
• Low Noise Quantizations (wan2.2_i2v_low_noise_14B_...): Best for high fidelity, generation stability, and strictly adhering to the prompt or structural layout of your starting frame. Available in: Q4_K_M, Q6_K_L, Q6_K, Q8_H, and fp8_scaled.

🧩 3. Modular Components

• /loras: Contains raw targeted weights (high_noise and low_noise rank64 lightx2v 4-step) for modular multi-pass setups.
• /text_encoders: Contains umt5_xxl_fp16.safetensors (11.4 GB) to maximize text prompt processing accuracy.
• /vae: Contains Wan2_1_VAE_fp32.safetensors (508 MB) to prevent color degradation and artifacting during final video decoding.
• Note: A lighter alternative wan_2.1_bf16_vae.safetensors is also placed in the root directory for extra VRAM safety during low-tier runs.

---