Important

This repo has moved. The plugin now lives in NousResearch/hermes-official-plugins/touchdesigner, the single repo for Nous's official Hermes plugins. Its history, open issues and pull requests went with it, and this repo is archived.

Already installed? hermes plugins update moves you to the new home automatically. New install: hermes plugins install from the plugin catalog.

hermes-plugin-touchdesigner

Drive a live TouchDesigner session from Hermes Agent through 404.zero's free twozero plugin, which embeds an MCP server inside the running TouchDesigner process (Streamable HTTP on 127.0.0.1:40404).

This is a portable Agent Plugins v1 package. It ships two things in one install:

• mcp.json — the twozero MCP server entry (td), registered for every session while the plugin is enabled. No mcp_servers edits in config.yaml.
• skills/touchdesigner-mcp/ — the workflow skill: critical rules, discovery steps, 20+ reference files (operators, GLSL, audio-reactive, instancing, pitfalls), and a scripts/setup.sh health check.

Install

hermes plugins install touchdesigner     # catalog name
hermes plugins enable td                 # manifest name (kept short: see below)

Then, once per machine, inside TouchDesigner (2025.32280+, Windows/macOS):

1. Download https://www.404zero.com/pisang/twozero.tox
2. Drag twozero.tox into the TD network editor and click Install.
3. twozero icon → Settings → mcp → "auto start MCP" → Yes.

Start TD first, then a new Hermes session. The skill is available as agent-plugin-td-<hash>:touchdesigner-mcp via skill_view (skills_list shows the exact name); health check:

curl -s http://127.0.0.1:40404/mcp

Why the manifest name is td

Hermes registers portable MCP tools as mcp__agent_plugin_<name>_<hash>__<server>__<tool>. twozero's longest tool name (td_screen_point_to_global) plus a touchdesigner namespace lands at 71 characters, past the 64-character function-name cap on OpenAI-compatible and Bedrock wire formats. td keeps every tool name at or under 60.

Security notes

• td_execute_python runs arbitrary Python inside TouchDesigner with no sandbox — the same trust level as the terminal tool. The hub is localhost-only and unauthenticated.
• All 36 twozero tools register. The desktop input-automation tools (td_input_*, td_click_screen_point, td_get_screen_screenshot, ...) and admin tools (td_project_quit, td_test_session — which exports transcripts to the vendor hub) are documented in the skill as opt-in: the agent is told to use them only on explicit request.
• Nothing in this package phones home. The only network access is the local MCP endpoint and the optional twozero.tox download in setup.sh.

Migrating from the bundled skill

Earlier Hermes versions shipped touchdesigner-mcp as an optional skill whose setup.sh wrote a twozero_td entry into mcp_servers. Remove that entry (or a touchdesigner one written by hermes mcp install) so the server is not loaded twice.

Credits

Skill authored by @kshitijk4poor; twozero by 404.zero. MIT.