siliconflow/ComfyUI-SeedVR2_VideoUpscaler

siliconflow/ComfyUI-SeedVR2_VideoUpscaler

Description: Official SeedVR2 Video Upscaler for ComfyUI

Language: Python

License: Apache-2.0

Stars: 1

Forks: 0

Open issues: 0

Created: 2025-09-02T14:39:49Z

Pushed: 2026-01-04T06:46:45Z

Default branch: main

Fork: yes

Parent repository: numz/ComfyUI-SeedVR2_VideoUpscaler

Archived: no

README:

ComfyUI-SeedVR2_VideoUpscaler

Official release of SeedVR2 for ComfyUI that enables high-quality video and image upscaling.

Can run as Multi-GPU standalone CLI too, see [🖥️ Run as Standalone](#-run-as-standalone-cli) section.




📋 Quick Access

• [🆙 Future Work](#-future-work)
• [🚀 Release Notes](#-release-notes)
• [🎯 Features](#-features)
• [🔧 Requirements](#-requirements)
• [📦 Installation](#-installation)
• [📖 Usage](#-usage)
• [🖥️ Run as Standalone](#️-run-as-standalone-cli)
• [⚠️ Limitations](#️-limitations)
• [🤝 Contributing](#-contributing)
• [🙏 Credits](#-credits)
• [📜 License](#-license)

🆙 Future Work

We're actively working on improvements and new features. To stay informed:

• 📌 Track Active Development: Visit Issues to see active development, report bugs, and request new features
• 💬 Join the Community: Learn from others, share your workflows, and get help in the Discussions
• 🔮 Next Model Survey: We're looking for community input on the next open-source super-powerful generic restoration model. Share your suggestions in Issue #164

🚀 Release Notes

2025.12.24 - Version 2.5.24

• 🍎 Fix: MPS memory leak regression - Restored MPS cache clearing after VAE encode/decode operations that was accidentally removed during code cleanup in v2.5.23

2025.12.24 - Version 2.5.23

• 🔒 Security: Prevent code execution in model loading - Added protection against malicious .pth files by restricting deserialization to tensors only
• 🎥 Fix: FFmpeg video writer reliability - Resolved ffmpeg process hanging issues by redirecting stderr and adding buffer flush, with improved error messages for debugging *(thanks @thehhmdb)*
• ⚡ Fix: GGUF VAE model support - Enabled automatic weight dequantization for convolution operations, making GGUF-quantized VAE models fully functional *(thanks @naxci1)*
• 🛡️ Fix: VAE slicing edge cases - Protected against division by zero crashes when using small split sizes with high temporal downsampling *(thanks @naxci1)*
• 🎨 Fix: LAB color transfer precision - Resolved dtype mismatch errors during video upscaling by ensuring consistent float types before matrix operations
• 🔧 Fix: PyTorch 2.9+ compatibility - Extended Conv3d memory workaround to all PyTorch 2.9+ versions, fixing 3x VRAM usage on newer PyTorch releases
• 📦 Fix: Bitsandbytes compatibility - Added ValueError exception handling for Intel Gaudi version detection failures on non-Gaudi systems
• 🍎 MPS: Memory optimization - Reduced memory usage during encode/decode operations on Apple Silicon *(thanks @s-cerevisiae)*

2025.12.13 - Version 2.5.22

• 🎬 CLI: FFmpeg video backend with 10-bit support - New --video_backend ffmpeg and --10bit flags enable x265 encoding with 10-bit color depth, reducing banding artifacts in gradients compared to 8-bit OpenCV output *(based on PR by @thehhmdb - thank you!)*
• 🍎 Fix: MPS bicubic upscaling compatibility - Added CPU fallback for bicubic+antialias interpolation on PyTorch versions before 2.8.0, resolving RGBA alpha upscaling errors on Apple Silicon
• ⚡ Fix: Cross-platform histogram matching - Replaced scatter_ operation with argsort+index_select for improved reliability across CUDA, ROCm, and MPS backends
• 🧹 MPS: Remove sync overhead - Reverted unnecessary torch.mps.synchronize() calls introduced in v2.5.21 for consistent behavior with CUDA pipeline

2025.12.12 - Version 2.5.21

• 🛠️ Fix: GGUF dequantization error on MPS - Resolved shape mismatch error introduced in 2.5.20 by skipping GGUF quantized buffers in precision conversion - these must remain in packed format for on-the-fly dequantization during inference
• 🍎 MPS: Eliminate CPU sync overhead - Skip unnecessary CPU tensor offload on Apple Silicon unified memory architecture, preventing sync stalls that caused slowdowns. Input images and output video now stay on MPS device throughout the pipeline
• ⚡ MPS: Preload text embeddings - Load text embeddings before Phase 1 encoding to avoid sync stall at Phase 2 start, improving timing accuracy and throughput
• 🧹 MPS: Optimized model cleanup - Skip redundant CPU movement before model deletion on unified memory

2025.12.12 - Version 2.5.20

• ⚡ Expanded attention backends - Full support for Flash Attention 2 (Ampere+), Flash Attention 3 (Hopper+), SageAttention 2, and SageAttention 3 (Blackwell/RTX 50xx), with automatic fallback chains to PyTorch SDPA when unavailable *(based on PR by @naxci1 - thank you!)*
• 🍎 macOS/Apple Silicon compatibility - Replaced MPS autocast with explicit dtype conversion throughout VAE and DiT pipelines, resolving hangs and crashes on M-series Macs. BlockSwap now auto-disables with warning (unified memory makes it meaningless)
• 🛡️ Flash Attention graceful fallback - Added compatibility shims for corrupted or partially installed flash_attn/xformers DLLs, preventing startup crashes
• 🛡️ AMD ROCm: bitsandbytes conflict fix - Prevent kernel registration errors when diffusers attempts to re-import broken bitsandbytes installations
• 📦 ComfyUI Manager: macOS classifier fix - Removed NVIDIA CUDA classifier causing false "GPU not supported" warnings on macOS
• 📚 Documentation updates - Updated README with attention backend details, BlockSwap macOS notes, and clarified model caching descriptions

2025.12.10 - Version 2.5.19

• 🎨 New header logo design - Refreshed ASCII art banner *(thanks…