- GUIDES
Installation
LOPs installs from inside TouchDesigner — no terminal, no manual Python setup.
- 1 Open the LOPs component dot_lops
Select the main LOPs component in your project.
- 2 Go to Environment Environment page
This is the first-run setup panel. Everything starts here.
- 3 Pick a folder folder picker
Choose where LOPs should create its Python environment. Avoid paths with spaces.
- 4 Press Install Install button
LOPs creates the environment and installs core packages. A command window may appear briefly — that's normal.
LOPs uses UV as its package manager. You do not need to install UV yourself — if it is missing, LOPs will detect that and offer to download it during the install flow.
After Install
Section titled “After Install”Open the Settings UI and go to the ChatTD tab. This is where you choose your provider, paste an API key, and pick a model.
- Cloud providers (OpenRouter, OpenAI, Anthropic, Groq, Gemini) need an API key.
- Local servers (Ollama, LM Studio, llama.cpp) connect through localhost and usually do not need a cloud key.
- Custom endpoints let you point to any OpenAI-compatible
/v1server.
When you place a new Agent, it copies whatever provider and model you have set in ChatTD. You can override those on any individual Agent’s Model page.
Quick Checks
Section titled “Quick Checks”After install, verify:
- The Environment page shows a remembered folder path.
- ChatTD has a provider and model selected.
- Sending a message to a freshly placed Agent gets a response.
- If using a cloud key, paste it into ChatTD’s key field and press Enter.
Troubleshooting
Section titled “Troubleshooting”- Project seems frozen during install. Normal while the environment is being created. Wait for the command window to close.
- Agent returns an error on first message. Check that ChatTD has a valid provider, model, and key configured.
- UV issues. If the UV prompt did not appear or failed, you can install UV manually and retry.