Docs · Questions
StreamDiffusionTDInstallation
What Python and CUDA versions do I need for StreamDiffusionTD v0.3.1 and how do I install them?
Python & CUDA Installation for StreamDiffusionTD v0.3.1
Requirements Summary
| Component | Required Version | Notes |
|---|---|---|
| Python | 3.11.9 (preferred) or 3.10.9 | NOT 3.12, NOT 3.13 |
| CUDA Toolkit | 12.8 (recommended) | 12.1 also works |
| cuDNN | Included with CUDA | Auto-installed |
| GPU | NVIDIA with 6GB+ VRAM | See VRAM requirements |
Step-by-Step Installation
1. Check Current Versions
Open Command Prompt and run:
python --version
nvcc --version
2. Install Python 3.11.9
If you have Python 3.12 or 3.13, you need to install 3.11.9:
- Download from: https://www.python.org/downloads/release/python-3119/
- Select “Windows installer (64-bit)”
- IMPORTANT: Check “Add Python to PATH” during install
- If you have multiple Python versions, you may need to:
- Uninstall newer versions, OR
- Adjust PATH to prioritize 3.11.9
Why 3.11.9? Per dotsimulate: “recommended python version is 3.11.9 (3.10.9 works, but recently found 3.11.9 works as well and is preferred)”
Python 3.13 has known compatibility issues with StreamDiffusion dependencies.
3. Install CUDA Toolkit 12.8
- Download from: https://developer.nvidia.com/cuda-12-8-0-download-archive
- Select: Windows → x86_64 → Your Windows version → exe (network or local)
- Run installer with default options
- Restart your computer after installation
Verify CUDA installation:
nvcc --version
Should show “release 12.8”
4. Verify NVIDIA Driver
CUDA 12.8 requires driver version 525.60.13 or newer.
Check your driver:
nvidia-smi
Update if needed from: https://www.nvidia.com/drivers
Common Installation Issues
“cudart” Import Error
ERROR: cannot import name 'cudart' from 'cuda'
Fix: CUDA not properly installed or not in PATH. Reinstall CUDA and restart.
Python Version Mismatch
ERROR: Could not find a version that satisfies the requirement torch==2.1.0
Fix: Wrong Python version. Check python --version - must be 3.10.x or 3.11.x.
Multiple Python Versions
If you have multiple Python versions:
- Use full path to Python 3.11:
C:\Python311\python.exe - Or adjust system PATH to prioritize correct version
- Or uninstall conflicting versions
polygraphy Missing
ModuleNotFoundError: No module named 'polygraphy'
Fix: You skipped Step 3 (Install TensorRT). Go back and click that pulse button.
Base Folder Naming Conflict
Don’t name your installation folder “streamdiffusion” - this conflicts with the Python module name.
Use something like:
C:/AI/StreamDiffusion_v030/D:/SD/StreamDiff/
CUDA Version Compatibility
| CUDA Version | Status |
|---|---|
| 12.8 | ✅ Recommended for v0.3.1 |
| 12.1 | ✅ Works (original recommendation) |
| 12.9 | ⚠️ May have issues |
| 11.8 | ⚠️ Legacy - for pre-v0.2.6 only |
After Installation
- Restart TouchDesigner (or restart PC)
- Open StreamDiffusionTD operator
- Go to Install tab
- Set Base Folder to a NEW folder (not existing v0.2.99)
- Click “Clone StreamDiffusion”
- Click “Install StreamDiffusion”
- Click “Install TensorRT” (don’t skip this!)
- Wait for installation to complete
- Run
python -m sd_installer verifyto confirm everything installed correctly
Troubleshooting: If installation still fails, run python -m sd_installer diagnose and check FAQ #1 for common issues.