mirrors/hermes-agent
1
0
Fork 0
mirror of https://github.com/NousResearch/hermes-agent.git synced 2026-07-31 19:16:29 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 2

docs(touchdesigner): gate skill to macos/windows — TD has no Linux build

Browse source 
Live testing confirmed TouchDesigner ships Windows/macOS builds only, so the
localhost workflow is impossible on Linux. Drop linux from the skill's
platforms gate, state the constraint (and the remote-TD escape hatch: point
the mcp_servers.touchdesigner url at a Windows/macOS machine that forwards
twozero's localhost-bound port) in SKILL.md and the catalog post_install,
and note TD Non-Commercial is free. Docs page regenerated.
This commit is contained in:
Teknium 2026-07-21 12:40:29 -07:00
parent 968efb0d24
commit 6096ad3d77
No known key found for this signature in database
3 changed files with 25 additions and 3 deletions
Download patch file Download diff file Expand all files Collapse all files

8
optional-mcps/touchdesigner/manifest.yaml
View file

@ -70,7 +70,13 @@ tools:
post_install: |
This entry connects to the twozero plugin's MCP server, which runs INSIDE
TouchDesigner (2025.32280+). One-time setup in TD:
TouchDesigner (2025.32280+). TouchDesigner is Windows/macOS only — there is
no Linux build. On a Linux Hermes host, TD must run on another machine:
make twozero's port reachable from Hermes (it binds localhost, so forward
it on the TD machine) and edit the url in mcp_servers.touchdesigner to
point at that machine's IP.
One-time setup in TD:
1. Download https://www.404zero.com/pisang/twozero.tox
2. Drag twozero.tox into the TD network editor and click Install.

10
skills/creative/touchdesigner-mcp/SKILL.md
View file

@ -4,7 +4,7 @@ description: "Control a running TouchDesigner instance via twozero MCP — creat
version: 1.2.0
author: kshitijk4poor
license: MIT
platforms: [linux, macos, windows]
platforms: [macos, windows]
metadata:
hermes:
tags: [TouchDesigner, MCP, twozero, creative-coding, real-time-visuals, generative-art, audio-reactive, VJ, installation, GLSL]
@ -28,7 +28,15 @@ metadata:
Hermes Agent -> MCP (Streamable HTTP) -> twozero.tox (port 40404) -> TD Python
```
**TouchDesigner runs on Windows and macOS only — there is no Linux build**, so
the standard localhost workflow cannot work on Linux. (A Hermes host can still
drive TD on ANOTHER machine by pointing the `mcp_servers.touchdesigner` url at
that machine's IP, but TD itself must live on Windows/macOS and twozero binds
localhost by default — the TD machine has to forward the port.)
36 native tools. Free plugin (no payment/license — confirmed April 2026).
TouchDesigner Non-Commercial is free too (requires a free derivative.ca
account to activate).
Context-aware (knows selected OP, current network).
Hub health check: `GET http://localhost:40404/mcp` returns JSON with instance PID, project name, TD version.

10
website/docs/user-guide/skills/bundled/creative/creative-touchdesigner-mcp.md
View file

@ -19,7 +19,7 @@ Control a running TouchDesigner instance via twozero MCP — create operators, s
| Version | `1.2.0` |
| Author | kshitijk4poor |
| License | MIT |
| Platforms | linux, macos, windows |
| Platforms | macos, windows |
| Tags | `TouchDesigner`, `MCP`, `twozero`, `creative-coding`, `real-time-visuals`, `generative-art`, `audio-reactive`, `VJ`, `installation`, `GLSL` |
| Related skills | `native-mcp`, [`ascii-video`](/docs/user-guide/skills/bundled/creative/creative-ascii-video), [`manim-video`](/docs/user-guide/skills/bundled/creative/creative-manim-video), `hermes-video` |
@ -45,7 +45,15 @@ The following is the complete skill definition that Hermes loads when this skill
Hermes Agent -> MCP (Streamable HTTP) -> twozero.tox (port 40404) -> TD Python
```
**TouchDesigner runs on Windows and macOS only — there is no Linux build**, so
the standard localhost workflow cannot work on Linux. (A Hermes host can still
drive TD on ANOTHER machine by pointing the `mcp_servers.touchdesigner` url at
that machine's IP, but TD itself must live on Windows/macOS and twozero binds
localhost by default — the TD machine has to forward the port.)
36 native tools. Free plugin (no payment/license — confirmed April 2026).
TouchDesigner Non-Commercial is free too (requires a free derivative.ca
account to activate).
Context-aware (knows selected OP, current network).
Hub health check: `GET http://localhost:40404/mcp` returns JSON with instance PID, project name, TD version.