SeedVR2 ComfyUI Install Guide: 3B/7B & Missing Nodes
SeedVR2 ComfyUI install: update to 0.28.0, place seedvr2_3b_int8_convrot.safetensors and the VAE in the right folders, then fix OOM and missing nodes.
Direct answer
Installing locally? Open the current native SeedVR2 template in an updated ComfyUI. Put seedvr2_3b_int8_convrot.safetensors in models/diffusion_models and seedvr2_ema_vae_fp16.safetensors in models/vae, then run the supplied sample. Use the download links inside the template, keep filenames unchanged, and restart after installation. The v2.5 name refers to the separate community integration. These local files and controls are not settings for the hosted browser tools.
- Update ComfyUI to 0.28.0 or newer, then search the Template Library for the native SeedVR2 3B INT8 image or video workflow.
- Download the matching Comfy-Org diffusion model and VAE into the folders named inside the template.
- Treat v2.5 custom nodes, GGUF, and BlockSwap as a separate community path—not the default native install or an 8GB guarantee.
- Need a still image or video without local setup? Use the matching browser tool below; files are uploaded for hosted processing and its own pricing applies.
Door 1
Do not want to install? Use the browser
Choose the image tool for a still or the video tool for a clip. Both upload your source for hosted processing; they do not install ComfyUI or run these local settings on your computer.
Door 2
Keep installing locally
Continue the checklist, model folders, and VRAM notes on this page.
First-party before/after SeedVR2 proof


This comparison uses a first-party demo source and output published on this page. It is not a third-party customer asset or a promise about every source type.
- Start with ComfyUI 0.28.0 or newer and its native SeedVR2 template; add a community node only for features the core workflow does not provide.
- Treat 8GB experiments as unsupported community tuning, not an upstream hardware promise.
- Use the online workspace when missing nodes, model downloads, CUDA errors, or client deadlines block local setup.
Jump to a task
- Install SeedVR2 ComfyUI with the native 3B/7B workflow first
- Local hardware and software checklist
- Choose native ComfyUI, a community node, or the browser
- Community v2.5 workflow: the four-node map
- Model choice: 3B, 7B, FP16, FP8, and GGUF
- VRAM boundaries and unsupported 8GB experiments
- Source quality, 2K, 4K, and 8K expectations
- seedvr2 comfyui troubleshooting: OOM, missing nodes, VAE
- Video batch size and temporal stability
- A practical quality-review checklist
Install SeedVR2 ComfyUI with the native 3B/7B workflow first
SeedVR2 ComfyUI install starts with ComfyUI 0.28.0 or newer. Restart it, then search the Template Library for a SeedVR2 3B INT8 image or video workflow. The maintained template uses native core nodes, points to seedvr2_3b_int8_convrot.safetensors and seedvr2_ema_vae_fp16.safetensors, and shows their exact folders. This is now the shortest current install path; an old v2.5 custom-node graph should not be your first test.
Download the diffusion model into ComfyUI/models/diffusion_models and the VAE into ComfyUI/models/vae, keep the filenames unchanged, reopen the template, select both files, and queue its bundled sample before adding your own source. A successful sample separates installation problems from source-file problems.
- Update ComfyUI to 0.28.0 or newer and restart it.
- Open a native SeedVR2 template from the Template Library.
- Place the 3B INT8 diffusion model and shared VAE in the documented folders.
- Run the bundled sample once before changing the source or model.
seedvr2 safetensors file names and their exact foldersseedvr2 model download: files, folders and free disk space
Local hardware and software checklist
Check the requirements of your chosen ComfyUI build and integration, including GPU support, drivers, system memory, and disk space. ByteDance publishes H100 reference commands. NumZ now documents low-memory community examples; its documentation does not establish the old 18GB floor as a universal minimum. See the sourced example table below before choosing settings.
Keep ComfyUI and custom nodes in a dedicated environment. Updating every dependency at once makes troubleshooting difficult. Record the working ComfyUI revision, custom-node revision, model filename, output resolution, tile settings, and GPU driver before changing anything. That small record is often the difference between a repeatable workflow and an unexplained break after an update.
- Update the GPU driver before diagnosing CUDA or attention errors.
- Keep at least twice the model size available as free disk space.
- Confirm the downloaded model checksum when the publisher provides one.
- Test one image before starting a batch.
Choose native ComfyUI, a community node, or the browser
Use native ComfyUI when you want the maintained 3B/7B image or video templates and normal ComfyUI model loading. Use the v2.5 community custom node only when a known workflow needs its GGUF, BlockSwap, attention, or batch controls. Those extensions have their own version and dependency risks and should stay clearly labeled as community software.
Use the browser workspace when you need one deliverable and local setup is the obstacle. The online path avoids Python, CUDA, model downloads, and custom-node conflicts, but it sends the file to a hosted provider under the published privacy and retention policy. Choose based on the asset and deadline, not on the assumption that local is always free or online is always private.
- Native template: simplest maintained install for current ComfyUI.
- Community node: only for a workflow that names its extra controls.
- Browser: best when a finished file matters more than local ownership.
- Run one low-resolution test before a batch or 4K output.
Community v2.5 workflow: the four-node map
The separate v2.5 community integration is not the native-template requirement. It splits the workflow into a DiT model loader, a VAE loader, optional torch compile settings, and the main SeedVR2 upscaler node. That split is useful when you specifically need its memory and video controls, but it also adds another package that can break after updates.
The DiT loader is where you choose model family, precision, offload, attention backend, and BlockSwap. The VAE loader is where encode and decode tiling belong. The main upscaler node receives image frames, DiT, and VAE configuration, then controls resolution, max resolution, batch size, temporal overlap, color correction, and noise settings. Keeping that map in mind makes troubleshooting much faster.
- DiT loader: model, offload, attention, BlockSwap.
- VAE loader: encode/decode tiling and tile overlap.
- Torch compile: optional speed optimization after the workflow is stable.
- Main upscaler: resolution, batch size, temporal settings, color correction.
Model choice: 3B, 7B, FP16, FP8, and GGUF
ByteDance publishes the official 3B and 7B checkpoints under Apache-2.0. Comfy-Org repackages compatible files for ComfyUI, and NumZ separately maintains a community custom node with additional precision and memory options. FP8 and GGUF are community or integration choices; do not attribute them to ByteDance or turn them into an 8GB guarantee.
A good local process is to validate the source with a lighter model first, then compare one crop with a heavier model only if the lighter output is promising. If the source is a damaged portrait, unreadable text, or a heavily compressed clip, a larger model may create more believable artifacts rather than more truthful detail. Save side-by-side crops so the final decision is visible.
VRAM boundaries and unsupported 8GB experiments
ByteDance reference hardware and a community low-memory workflow describe different software paths. An example for a smaller GPU does not promise that every source, model, or output size will fit. Use the same short source when comparing settings and record failures as well as completed outputs.
Close GPU-heavy applications, avoid multiple queued images, and test the final aspect ratio at a smaller resolution. If the workflow still fails after conservative settings, the browser workspace is a useful fallback because it lets you finish the asset without spending more time on local dependency and memory tuning.
Source quality, 2K, 4K, and 8K expectations
ByteDance documents three important limits: heavily degraded inputs can fail, large motion can break restoration, and lightly degraded inputs can become over-sharpened. Upscaling cannot guarantee recovery of missing text, faces, or objects. Use 2K for the first comparison, and move to 4K only when the source passes crop or playback review.
Portraits with damaged faces, scanned family photos, and heavy grain should start in the old photo enhancer. Transparent PNG assets need careful edge inspection after processing. For client work, compare hair, eyes, small text, product edges, repeating patterns, and flat gradients at 100 percent zoom before approving the result.
seedvr2 comfyui troubleshooting: OOM, missing nodes, VAE
An out-of-memory error means the current graph, resolution, or batch is larger than available VRAM. Reduce the output size or batch first, then try tiling or offload. A missing-node error means the workflow references a custom node that ComfyUI cannot load. A model error means the selected filename or directory is wrong. Seams usually point to tile overlap or blending settings. Washed colors or unexpected transparency require checking the input color profile and output format.
If setup keeps failing, save the terminal error, workflow JSON, source dimensions, model, and GPU details. The browser image and video links above offer a separate hosted path while you debug. Use the tool that matches your file, check its quote before submitting, and review the output before accepting it.
Video batch size and temporal stability
For video, SeedVR2 quality is not just about target resolution. Batch size controls how many frames are processed together, which affects temporal consistency. The ComfyUI workflow expects normal video batches to follow a 4n+1 pattern such as 5, 9, 13, or 17 frames. Larger batches can improve consistency and speed on capable GPUs, but they also increase memory pressure.
If a video upscaling job fails on low VRAM, try memory optimizations before reducing batch size below the useful range. For still images, batch size can be one. For video, tiny batches can reduce flicker protection. When the local setup cannot keep a useful batch size, the online video upscaler is the better fallback because it keeps the source in a video-specific lane.
A practical quality-review checklist
Review the finished image beside the original, not from memory. Check whether the result preserves identity, proportions, typography, logos, and the direction of fine texture. Inspect both the full composition and a 100 percent crop. A larger file is not a better file when edges ring, skin becomes plastic, or small letters change.
Keep the original file, record the model and settings, and download important online outputs before the 30-day creation cleanup window. For a new source type, run one representative sample before committing an entire batch. This keeps local GPU time and online credits predictable.
Hosted image upscaler for a quick side-by-sideOnline video upscaler for a clip that will not fit locally
Who this guide is for
Built for search visitors who need a finished upscale, local ComfyUI users choosing between native SeedVR2 and community extensions, and teams deciding whether online delivery is safer than local GPU maintenance.
Test method and evidence scope
- Published
- 2026-07-31
- Updated
- 2026-08-23
- Owned online proof
- WaveSpeed SeedVR2 image endpoint, owned SVG source, 768px input to 2048px WebP output, submitted 2026-07-20.
- Local ComfyUI evidence scope
- Use this page as the capture checklist for RTX 8GB, 12GB, 16GB, and 24GB+ local validation before publishing hardware-specific claims.
- Success standard
- 100 percent crop or timestamp review must preserve identity, text, edges, color, and motion without hiding setup failures.
GPU and parameter table
Source: the NumZ community README, Typical Workflow Setup. These are published example settings, not measured speed, quality, or maximum-resolution results from SeedVR2.net. Native ComfyUI uses different controls. Keep the input, model revision, output size, and peak VRAM in your own run log.
| VRAM | Model | VAE tiling | BlockSwap | Batch | Output limit | Risk |
|---|---|---|---|---|---|---|
| 8–12GB: community example, not our benchmark | NumZ 3B Q8_0 GGUF | Encode and decode tiling enabled | 32 blocks, CPU offload, swap I/O enabled | 5 video frames | 720 target in the maintainer example; no maximum established | Slower transfers; a different source can still fail |
| 16GB: no measured preset supplied | Choose a workflow-compatible model | Change only when the failing stage calls for it | Community control; diagnose inference OOM first | Record the actual frame batch | Not established by a controlled test on this page | VRAM capacity alone does not predict success or quality |
| 24GB+: community example, not our benchmark | NumZ 3B FP16 | Record actual settings | Not specified in the basic example | 21 video frames | 1080 target in the maintainer example; no maximum established | This does not establish a 7B or 4K guarantee |
Next step: run one file online
Put one source file through the browser workspace and compare the result with the original before you commit further. The credit cost for the whole task is shown before it starts, so the first run is a measured decision rather than a guess.
Troubleshooting errors people actually search
SeedVR2 missing node
The workflow references a node type that this ComfyUI build cannot load. A native template usually means ComfyUI is outdated; a v2.5 community workflow may require its matching custom node.
Update ComfyUI to 0.28.0 or newer and reopen the official SeedVR2 template first. Only install the matching community node when the workflow explicitly depends on it, then restart and resolve the first terminal error.
CUDA out of memory
The graph, model precision, frame batch, or target resolution is larger than the available VRAM for the current run.
Reduce target size or batch first, then enable VAE tiling, CPU offload, GGUF/FP8 models, or BlockSwap in that order.
model not found
The node loaded correctly, but the workflow-selected model filename does not match the local folder scanned by the node.
Place DiT and VAE files in the documented SeedVR2 model folder, keep filenames unchanged, restart ComfyUI, and select the exact model in the loader.
VAE decode crash
Encoding or decoding large frames can fail separately from DiT model inference, especially at 4K or with long clips.
Enable VAE tiling, start with a conservative tile size and overlap, then increase output size only after a smaller pass succeeds.
ComfyUI Manager install failed
The node package may be blocked by Python environment mismatch, dependency conflicts, or a stale Manager cache.
Confirm the base ComfyUI workflow runs, install one node package at a time, restart, and use the browser workspace when the asset must ship before dependency repair.
Workflow decision table
| Scenario | Recommended path | Local setting | Online fallback | Risk |
|---|---|---|---|---|
| One clean still image, product shot, or AI artwork | Online image upscaler | Batch 1, 2K first, inspect 100 percent crop | /tools/upscaler | 4K can amplify artifacts when the 2K crop already fails |
| Repeatable local ComfyUI workflow | Local SeedVR2 v2.5 graph | Record DiT, VAE, precision, tiling, offload, BlockSwap, and batch | /blog/tutorials/seedvr2-v25-installation-guide-2026 | Missing nodes and model paths can consume more time than the asset is worth |
| Motion clip, reel, or compressed video | Online video upscaler | Use 4n+1 batches only if running a video graph locally | /tools/video-upscaler | Frame-by-frame image upscaling can cause temporal inconsistency |
| Old portrait, family scan, or identity-sensitive face | Photo enhancement first | Conservative face review before enlargement | /tools/photo-enhance | Sharper faces can still become the wrong identity |
Choosing between the browser and a local install
Check the selected resolution, eligibility, and quoted credits in the tool before submitting. An image trial is not a free video job or unlimited 4K processing. Keep local processing when your source must stay on your own machine.
Sources and update notes
Checked against the linked ByteDance, Hugging Face, Comfy-Org, and ComfyUI sources plus the displayed first-party comparison.
- ByteDance Seed official repository
Upstream source for the Apache-2.0 license, official 3B/7B checkpoints, snapshot_download examples, H100 reference environment, and documented model limitations.
- Comfy-Org ComfyUI repack
ComfyUI-formatted model files and their exact diffusion_models and VAE directories; this is a repack, not the ByteDance model publisher.
- NumZ community custom node
Community-maintained custom node used for v2.5 layout, GGUF, tiling, BlockSwap, and batch behavior; it is not an official ByteDance release.
- Official ComfyUI video upscaling documentation
Current ComfyUI documentation exposes both open-source and hosted SeedVR2 workflows and recommends testing sample clips before full processing.
- Official ComfyUI SeedVR2 workflow template
The maintained template identifies ComfyUI core 0.28.0, the 3B INT8 diffusion model, the shared VAE, exact model folders, and native SeedVR2 support.
- SeedVR2 paper
Used for the one-step video restoration framing and source-quality expectations.
- First-party SeedVR2 image comparison
Before/after image proof generated from a self-authored SVG source, with request metadata published alongside the asset.
Related SeedVR2 workflows and fixes
AI image upscaler — upscale a photo online
Upscale a photo online in the browser and see the credit cost before you run.
Can SeedVR2 Run on 8GB VRAM? OOM Fixes That Work
SeedVR2 on 8GB VRAM in ComfyUI is a community experiment, not an official promise. Reduce resolution, try INT8 or GGUF, VAE tiling, then BlockSwap.
SeedVR2 Upscale Beginner Guide for Korean Users
Beginner SeedVR2 upscale guide for Korean users: route the source first — still image, video, old photo, or ComfyUI — then pick the online or local workflow.
SeedVR2 Free 4K Upscaler Review: Does It Beat Originals?
An honest SeedVR2 4K upscaler review: what a free upscaler can and cannot improve, how to test one file before buying credits, and when it beats the original.
Credit pricing
Check credit cost before testing 4K, Pro video, or batch workflows.
AI video upscaler — upscale a video online
Open the AI video upscaler for duration pricing, model choice, and temporal cleanup.