How do I install or upgrade to StreamDiffusionTD v0.4.0?
Install or upgrade to StreamDiffusionTD v0.4.0
Full page: Installation Guide
v0.4.0 is a stack bump (torch 2.11, TensorRT 10.16, CUDA 12.8 only, cuda-link). ControlNet, IP Adapter, StreamV2V, and live LoRA weight now run together on TensorRT.
Fresh local install
- Python 3.11.9 on PATH. Not 3.12, not 3.13, not 3.10
- Git on PATH
- Drag
streamdiffusiontd_0.4.0.toxinto TouchDesigner - Install page: new empty Basefolder (do not name it
streamdiffusion) - Step 1 Clone, Step 2 Install (venv), Step 3 Install TensorRT
- Restart TouchDesigner so cuda-link sees
CUDALINK_LIB_PATH - Acceleration =
tensorrt. Start stream. First engine build takes a while python -m sd_installer verifyfrom the installer folder after activating the venv
Upgrade from v0.3.1
- Save the project
- Load the v0.4.0 tox
- Install Step 1, take Full Update (repo + fresh venv). Old venv is renamed, not deleted
- Restart TouchDesigner
python -m sd_installer verify
Upgrade from a v0.4.0 beta
Same as v0.3.1, plus delete engines/td/ before first run.
If you used Local ↔ Daydream swap on a beta, reset the tox registry first. Skip this if you never ran a 0.4.0 beta.
- Close TouchDesigner
- In File Explorer, paste
%APPDATA%\dotsimulate_TD_Toolsinto the address bar - Delete
streamdiffusiontd_toxes.json - In
toxes, deletestreamdiffusiontd_Local_0.4.0b.toxandstreamdiffusiontd_Daydream_0.4.0b.toxif they are there. Leave 0.3.1 files alone - Open TouchDesigner, drop
streamdiffusiontd_0.4.0.tox, let it finish loading
If Full Update is refused
That checkout's git origin is a personal fork. Use Fresh Install (New Location).
After install
- First ControlNet stream rebuilds once
- TensorRT is required for ControlNet, IP Adapter, and StreamV2V
- Slow installs mentioning
pypi.ngc.nvidia.com: see the NameResolutionError FAQ. Updating StreamDiffusionTD does not remove that leftover pip config
python -m sd_installer diagnose in Discord #troubleshoot-central and tag @dotsimulate.