LOPs is a native operator family for TouchDesigner — agents, tools, speech, retrieval, generative workflows, stateful automation, and authorable systems, built directly into your TD project.

Your First Session

1. 1 Install Environment page

   Open the LOPs component, go to Environment, pick a folder, and press Install. If UV is missing, LOPs will offer to download it.

2. 2 Configure a model ChatTD

   Open ChatTD from the Settings UI. Choose a provider, paste your API key (or point to a local server), and pick a model.

3. 3 Place an Agent OP Create > LOP tab

   Drop an Agent into your network. It inherits your ChatTD defaults — send it a message and you should get a response.

4. 4 Give it a tool Agent Tools page

   Place a tool operator like Search or Tool DAT nearby. On the Agent's Tools page, turn on Use LOP Tools and drag the operator into the External Op Tools sequence.

Guides

Installation Environment setup, folder picker, and what happens during install.

Providers and Models Cloud keys, local servers, custom endpoints, and how Agents inherit defaults.

Use Tools with Agents How operators expose tools, how Agents call them, and how to wire the sequence.

Local Models Run LM Studio, Ollama, or llama.cpp alongside TouchDesigner.

External Agent Control Let Cursor, a custom MCP client, or another outside agent control your TD project.

SideCars Isolated services for embeddings, vision, speech, and music generation.

Operator Paths

Agents — Agent , Voice Agent , and Claude Code are the agent operators. Agent handles text-based conversations and tool use. Voice Agent adds realtime speech. Claude Code connects to a local Claude Code CLI session with full parameter control over the Claude Agent SDK.

Tools — see the tools guide. Agents call tools exposed by other operators through the External Op Tools sequence.

Voice — STT , TTS , and Voice Activity handle speech-to-text, text-to-speech, and voice activity detection as standalone pipeline operators.

Retrieval — Search Text , Search RAG , and Graph cover keyword search, semantic retrieval, and graph memory.

External control — MCP Server and Tool Manager expose your project’s tools to outside agents. See External Agent Control.

Vision, generation, and heavier models — operators like Florence, OCR, ACE-Step, and Gemini Image Gen use SideCar services when they need a separate Python process.

ActivityViz visualizes agent and tool activity in real time — ships with eight bundled display modules.

Browse the full ecosystem on the operator map.