Skip to content
LOPS Docs

Installation Guide

This guide walks you through the complete installation process for LOPs (Language/Learning/Logic/Latent Operators) in TouchDesigner. Much of the content is covered in the video below as well.

System Requirements

Section titled “System Requirements”
  • TouchDesigner (2023.11000 or newer recommended)
  • Windows 10/11 or macOS 10.15+
  • Python 3.11.9 (critical requirement - see below)
  • Internet connection for API-dependent operators

Python 3.11.9 Requirement

Section titled “Python 3.11.9 Requirement”

Installation Process

Section titled “Installation Process”
1

Initial Setup

Drag the LOPs .tox file into your TouchDesigner project.
  • Your project may freeze momentarily - this is normal
  • The LOPs container will appear and then disappear, placing itself at the root of your project
  • Press Tab to open the OP Create Dialog - you'll now see the new LOP family available
2

Launch Installation

Begin the automated installation process.
  • In the OP Create Dialog, locate the dot_lops container at the root of your project
  • Click Install / Modify LOPs button
  • You'll see a message: "No LOP installation detected"
  • Click Setup Install
3

Choose Installation Location

Select where LOPs will be installed on your system.
  • A folder selection dialog will appear
  • Choose or create a folder for your LOPs installation
  • TouchDesigner will freeze briefly while creating the virtual environment
  • A command window will appear showing the installation progress
💡 Avoid spaces in folder names. This folder will be used system-wide across all TouchDesigner projects.
4

Handle Installation Bug

Work around a known issue in version 0.1.0.
  • Due to a current bug, the installation dialog may close unexpectedly
  • If this happens, click Install / Modify LOPs again
  • The system should now recognize the installation
⚠️ This is a known bug that will be fixed in the next version.
5

Verify Installation Paths

Ensure both installation paths are correctly set.
  • Check that LOPs Install Path (in main LOPs container) is set
  • Verify Python Base Folder (in ChatTD parameters) matches the same path
  • If they don't match, manually set them to the same installation folder
💡 Both paths should point to the same installation directory to avoid conflicts.

API Key Configuration

Section titled “API Key Configuration”

Setting Up API Keys

Section titled “Setting Up API Keys”
  1. In the OP Create Dialog, click ChatTD (top-left)
  2. This opens the ChatTD parameters panel
  3. Navigate to the API configuration section
  4. For each service you want to use:
    • Click Get API Key button (opens the service’s website)
    • Create an account and generate an API key
    • Copy and paste the key into the appropriate field
    • The system will confirm with “API key stored”

Supported Services

Section titled “Supported Services”
  • OpenRouter (recommended for testing - includes free models)
  • OpenAI
  • Groq
  • Gemini
  • Ollama (local)
  • LM Studio (local)

Common Issues & Quick Fixes

Section titled “Common Issues & Quick Fixes”

MCP Server Dependencies

Section titled “MCP Server Dependencies”

RAG Indexer Local Embeddings

Section titled “RAG Indexer Local Embeddings”

Gemini Live Tool Errors

Section titled “Gemini Live Tool Errors”

Troubleshooting

Section titled “Troubleshooting”

API Key Issues

Section titled “API Key Issues”

If operators show read-only parameters after entering an API key:

  • Right-click on the read-only parameter
  • Select “Turn off read only” from the context menu
  • Re-enter your API key

Project Freezing

Section titled “Project Freezing”
  • TouchDesigner may freeze during installations - this is normal
  • Wait for the process to complete before continuing
  • Check the textport (Alt+T) for installation progress

Installation Debugging

Section titled “Installation Debugging”

Next Steps

Section titled “Next Steps”

Once installation is complete: