Files
heyburns-PortraitUtils/docs/SeedVR2Prep.md
T
2025-10-16 20:30:20 -05:00

45 lines
1.9 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# SeedVR2Prep
`SeedVR2Prep` prepares heavy SeedVR2 workflows by warming up caches, priming key models, and cleaning up afterward. Think of it as a one-button “get ready to render” helper for VRAM-intensive runs.
---
## Inputs
- `run_warmup` – Execute the warmup pass, loading and touching key models so the first real render doesn’t spike.
- `warmup_steps` – Number of dummy steps to run during warmup. Higher values build a larger cache but take longer.
- `clear_after` – Free caches once the main job finishes. Leave on if you’re about to switch projects.
- `log_only` – When `True`, print what would happen without actually running warmup or cleanup. Useful for testing.
- `notes` – Free-form text stored alongside the log output.
---
## Outputs
- `log` – Summary of warmup and cleanup actions.
- `status` – Simple text flag (`ready`, `skipped`, `cleared`) for downstream branching.
---
## Where It Fits
Drop SeedVR2Prep at the start of VRAM-heavy SeedVR2 graphs when you need stable runtimes or when the first render tends to hitch due to lazy model loading. Run it again at the end to clean up before switching to a different project or model set.
---
## Tuning Tips
- Start with a modest `warmup_steps` count (e.g., 5) and increase only if the first render still stutters.
- Leave `clear_after` enabled on shared machines so other users get a clean slate.
- Toggle `log_only` during setup to verify the node sees the right models before committing to a full warmup.
---
## Troubleshooting
- **Warmup takes too long** – Lower `warmup_steps` or limit which models participate in warmup within your workflow.
- **VRAM still spikes on first render** – Ensure `run_warmup` is enabled and the node executes before the main generation block.
- **Cleanup skipped** – Check that `clear_after` is toggled on and the node executes after your main render branch.
---
Screenshot: `docs/screenshots/seedvr2_prep.png`