Docs · Questions
StreamDiffusionTDUsage
How do I download models for StreamDiffusionTD? Should I use the built-in HuggingFace downloader?
GPU and suggested starting settings - use this guide for current configuration advice.
StreamDiffusionTD Model Download Methods
Recommended Methods (All Versions)
Method 1: HuggingFace Model ID (Recommended)
Use the model ID directly in the “Model Id” parameter:
stabilityai/sd-turbo(default)stabilityai/sdxl-turbo(v0.3.0+ only)prompthero/openjourney-v4- Any HuggingFace model ID
The operator downloads and caches the model automatically on first use.
Method 2: Direct .safetensors File
- Download
.safetensorsfile from HuggingFace or CivitAI - Place anywhere on your system
- Use full file path in “Model Id” parameter
- Example:
C:\Models\sd-turbo.safetensors
- Example:
Method 3: Diffusers Format Folder
- Download model in diffusers format (folder with
unet,vae,tokenizersubfolders) - Use full folder path in “Model Id”
- Example:
F:\StreamDiffusion\models\Model\stable-diffusion-v1-5
- Example:
⚠️ DEPRECATED: Built-in HuggingFace Downloader
DO NOT USE the old “Hugging Face Model Downloader” option (v0.1.5-v0.2.x).
- No longer recommended
- Can cause incomplete downloads
- Removed in v0.3.0
Model Compatibility - Important!
Not all models work with StreamDiffusionTD!
| Model Type | Works? | Notes |
|---|---|---|
| sd-turbo | ✅ Yes | Best choice |
| sdxl-turbo | ✅ Yes | v0.3.0+, memory use depends on configuration; see the GPU guide |
| SD 1.5 + LCM-LoRA | ✅ Yes | Need matching LCM-LoRA |
| Flux | ❌ No | Not realtime-capable |
| Video models | ❌ No | Use ComfyTD instead |
See FAQ “Model Compatibility” for full guide.
LoRA Compatibility Warning
sd-turbo is SD 2.1 based - SD 1.5 LoRAs won’t work with it!
| Model | LoRA Version Needed |
|---|---|
| sd-turbo | SD 2.1 LoRAs (rare) |
| SD 1.5 models | SD 1.5 LoRAs |
| SDXL models | SDXL LoRAs |
Git LFS Requirement
If you manually clone models from HuggingFace:
- Install Git LFS: https://git-lfs.github.com/
- Run:
git lfs install - Then clone the model repo
Error if missing: no file named diffusion_pytorch_model.bin found
Working Models List (Auto-Populated)
After successful streaming (200+ frames), models are saved to:
StreamDiffusion/streamdiffusionTD/working_models.json
These appear in the “My Models” dropdown for quick access.
Offline Usage
To run offline:
- Run the model once while online (downloads configs)
- Models are cached at:
~/.cache/huggingface/ - After first successful run, works offline
First run requires internet - even local .safetensors files need config downloads.
Updated: November 2025 - Added model compatibility info and LoRA warning