Questions

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:

  1. Download from: https://www.python.org/downloads/release/python-3119/
  2. Select “Windows installer (64-bit)”
  3. IMPORTANT: Check “Add Python to PATH” during install
  4. 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

  1. Download from: https://developer.nvidia.com/cuda-12-8-0-download-archive
  2. Select: Windows → x86_64 → Your Windows version → exe (network or local)
  3. Run installer with default options
  4. 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:

  1. Use full path to Python 3.11: C:\Python311\python.exe
  2. Or adjust system PATH to prioritize correct version
  3. 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

  1. Restart TouchDesigner (or restart PC)
  2. Open StreamDiffusionTD operator
  3. Go to Install tab
  4. Set Base Folder to a NEW folder (not existing v0.2.99)
  5. Click “Clone StreamDiffusion”
  6. Click “Install StreamDiffusion”
  7. Click “Install TensorRT” (don’t skip this!)
  8. Wait for installation to complete
  9. Run python -m sd_installer verify to confirm everything installed correctly

Troubleshooting: If installation still fails, run python -m sd_installer diagnose and check FAQ #1 for common issues.