Installation Guide

Choose Your Mode

Local Installation (GPU Required)

For running on your own hardware with full control.

Daydream Cloud (No GPU Required)

For cloud-based processing with multi-ControlNet support.

---

Local Installation

Prerequisites

• Python 3.11.9
  • Windows: Download Python 3.11.9 Windows Installer (direct download) or visit Python 3.11.9 Release Page for all options
  • Mac: Install Homebrew first, then run brew install python@3.11
• Git: Download here - check “Add to PATH”
• CUDA 12.1: Download here (Windows only, restart after install)

Steps

1. Load Operator: Drag StreamDiffusionTD.tox into TouchDesigner
2. Install Page: Go to Install parameter page
3. Download StreamDiffusion: Click button, select installation folder
4. Install Virtual Environment: Click button, wait for completion
5. Install TensorRT (Windows): Optional but recommended for performance

Upgrading from Previous Version

Version 0.2.6 and Later: If you installed StreamDiffusionTD version 0.2.6 or later, the operator will automatically detect your previous installation location when dropped into a new project. No manual setup required.

Earlier Versions: Set the Basefolder parameter to your previous installation location.

New Installation Options:

• Set a new Basefolder manually
• Use Reset Op button on Settings 3 page
• Hit Install and choose a different install location
• Use DotUpdater for seamless operator updates in existing projects

---

Daydream Cloud Installation

Prerequisites

• Python 3.11.9
  • Windows: Download Python 3.11.9 Windows Installer (direct download) or visit Python 3.11.9 Release Page for all options
  • Mac: Install Homebrew first, then run brew install python@3.11
• FFmpeg: Required for video processing - Download here

Steps

1. Load Operator: Drag StreamDiffusionTD.tox into TouchDesigner
2. Install Page: Select “Daydream” in backend selection
3. Install Daydream Backend: Click button, select folder
4. API Key: Enter your Daydream API key when prompted
5. Start Stream: Ready to use immediately

---

First Run

1. Go to Settings 1 page
2. Click Start Stream
3. Wait for “Streaming Active” message
4. Default prompt: “fancy banana” - modify as needed

Troubleshooting

• CUDA not found: Install CUDA 12.1 and restart computer (12.8 required for RTX 5090/5080)
• Python not found: Ensure Python 3.11.9 is installed and in PATH
• Installation fails: Delete virtual environment folder and retry. Avoid spaces in base folder path and do not use Microsoft OneDrive locations on Windows
• TouchDesigner crashes: Check numpy version (should be 1.24.1)