mirror of
https://github.com/NousResearch/hermes-agent.git
synced 2026-04-25 00:51:20 +00:00
feat: add TouchDesigner integration skill
New skill: creative/touchdesigner — control a running TouchDesigner
instance via REST API. Build real-time visual networks programmatically.
Architecture:
Hermes Agent -> HTTP REST (curl) -> TD WebServer DAT -> TD Python env
Key features:
- Custom API handler (scripts/custom_api_handler.py) that creates a
self-contained WebServer DAT + callback in TD. More reliable than the
official mcp_webserver_base.tox which frequently fails module imports.
- Discovery-first workflow: never hardcode TD parameter names. Always
probe the running instance first since names change across versions.
- Persistent setup: save the TD project once with the API handler baked
in. TD auto-opens the last project on launch, so port 9981 is live
with zero manual steps after first-time setup.
- Works via curl in execute_code (no MCP dependency required).
- Optional MCP server config for touchdesigner-mcp-server npm package.
Skill structure (2823 lines total):
SKILL.md (209 lines) — setup, workflow, key rules, operator reference
references/pitfalls.md (276 lines) — 24 hard-won lessons
references/operators.md (239 lines) — all 6 operator families
references/network-patterns.md (589 lines) — audio-reactive, generative,
video processing, GLSL, instancing, live performance recipes
references/mcp-tools.md (501 lines) — 13 MCP tool schemas
references/python-api.md (443 lines) — TD Python scripting patterns
references/troubleshooting.md (274 lines) — connection diagnostics
scripts/custom_api_handler.py (140 lines) — REST API handler for TD
scripts/setup.sh (152 lines) — prerequisite checker
Tested on TouchDesigner 099 Non-Commercial (macOS/darwin).
This commit is contained in:
kshitijk4poor
Teknium
parent
c49a58a6d0
commit
7a5371b20d
9 changed files with 3277 additions and 0 deletions
152
skills/creative/touchdesigner/scripts/setup.sh
Normal file
152
skills/creative/touchdesigner/scripts/setup.sh
Normal file
|
|
@ -0,0 +1,152 @@
|
|||
#!/usr/bin/env bash
|
||||
# TouchDesigner MCP Setup Verification Script
|
||||
# Checks all prerequisites and guides configuration
|
||||
|
||||
set -euo pipefail
|
||||
|
||||
RED='\033[0;31m'
|
||||
GREEN='\033[0;32m'
|
||||
YELLOW='\033[1;33m'
|
||||
BLUE='\033[0;34m'
|
||||
NC='\033[0m'
|
||||
|
||||
pass() { echo -e " ${GREEN}✓${NC} $1"; }
|
||||
fail() { echo -e " ${RED}✗${NC} $1"; }
|
||||
warn() { echo -e " ${YELLOW}!${NC} $1"; }
|
||||
info() { echo -e " ${BLUE}→${NC} $1"; }
|
||||
|
||||
echo ""
|
||||
echo "TouchDesigner MCP Setup Check"
|
||||
echo "=============================="
|
||||
echo ""
|
||||
|
||||
ERRORS=0
|
||||
|
||||
# 1. Check Node.js
|
||||
echo "1. Node.js"
|
||||
if command -v node &>/dev/null; then
|
||||
NODE_VER=$(node --version 2>/dev/null || echo "unknown")
|
||||
MAJOR=$(echo "$NODE_VER" | sed 's/^v//' | cut -d. -f1)
|
||||
if [ "$MAJOR" -ge 18 ] 2>/dev/null; then
|
||||
pass "Node.js $NODE_VER (>= 18 required)"
|
||||
else
|
||||
fail "Node.js $NODE_VER (>= 18 required, please upgrade)"
|
||||
ERRORS=$((ERRORS + 1))
|
||||
fi
|
||||
else
|
||||
fail "Node.js not found"
|
||||
info "Install: https://nodejs.org/ or 'brew install node'"
|
||||
ERRORS=$((ERRORS + 1))
|
||||
fi
|
||||
|
||||
# 2. Check npm/npx
|
||||
echo "2. npm/npx"
|
||||
if command -v npx &>/dev/null; then
|
||||
NPX_VER=$(npx --version 2>/dev/null || echo "unknown")
|
||||
pass "npx $NPX_VER"
|
||||
else
|
||||
fail "npx not found (usually comes with Node.js)"
|
||||
ERRORS=$((ERRORS + 1))
|
||||
fi
|
||||
|
||||
# 3. Check MCP Python package
|
||||
echo "3. MCP Python package"
|
||||
HERMES_HOME="${HERMES_HOME:-$HOME/.hermes}"
|
||||
VENV_PYTHON=""
|
||||
|
||||
# Try to find the Hermes venv Python
|
||||
if [ -f "$HERMES_HOME/hermes-agent/.venv/bin/python" ]; then
|
||||
VENV_PYTHON="$HERMES_HOME/hermes-agent/.venv/bin/python"
|
||||
elif [ -f "$HERMES_HOME/hermes-agent/venv/bin/python" ]; then
|
||||
VENV_PYTHON="$HERMES_HOME/hermes-agent/venv/bin/python"
|
||||
fi
|
||||
|
||||
if [ -n "$VENV_PYTHON" ]; then
|
||||
if $VENV_PYTHON -c "import mcp" 2>/dev/null; then
|
||||
MCP_VER=$($VENV_PYTHON -c "import importlib.metadata; print(importlib.metadata.version('mcp'))" 2>/dev/null || echo "installed")
|
||||
pass "mcp package ($MCP_VER) in Hermes venv"
|
||||
else
|
||||
fail "mcp package not installed in Hermes venv"
|
||||
info "Install: $VENV_PYTHON -m pip install mcp"
|
||||
ERRORS=$((ERRORS + 1))
|
||||
fi
|
||||
else
|
||||
warn "Could not find Hermes venv — check mcp package manually"
|
||||
fi
|
||||
|
||||
# 4. Check TouchDesigner
|
||||
echo "4. TouchDesigner"
|
||||
TD_FOUND=false
|
||||
|
||||
# macOS
|
||||
if [ -d "/Applications/TouchDesigner.app" ]; then
|
||||
TD_FOUND=true
|
||||
pass "TouchDesigner found at /Applications/TouchDesigner.app"
|
||||
fi
|
||||
|
||||
# Linux (common install locations)
|
||||
if command -v TouchDesigner &>/dev/null; then
|
||||
TD_FOUND=true
|
||||
pass "TouchDesigner found in PATH"
|
||||
fi
|
||||
|
||||
if [ -d "$HOME/TouchDesigner" ]; then
|
||||
TD_FOUND=true
|
||||
pass "TouchDesigner found at ~/TouchDesigner"
|
||||
fi
|
||||
|
||||
if [ "$TD_FOUND" = false ]; then
|
||||
warn "TouchDesigner not detected (may be installed elsewhere)"
|
||||
info "Download from: https://derivative.ca/download"
|
||||
info "Free Non-Commercial license available"
|
||||
fi
|
||||
|
||||
# 5. Check TD WebServer DAT reachability
|
||||
echo "5. TouchDesigner WebServer DAT"
|
||||
TD_URL="${TD_API_URL:-http://127.0.0.1:9981}"
|
||||
if command -v curl &>/dev/null; then
|
||||
HTTP_CODE=$(curl -s -o /dev/null -w "%{http_code}" --connect-timeout 3 "$TD_URL/api/td/server/td" 2>/dev/null || echo "000")
|
||||
if [ "$HTTP_CODE" = "200" ]; then
|
||||
TD_INFO=$(curl -s --connect-timeout 3 "$TD_URL/api/td/server/td" 2>/dev/null || echo "{}")
|
||||
pass "TD WebServer DAT responding at $TD_URL"
|
||||
info "Response: $TD_INFO"
|
||||
elif [ "$HTTP_CODE" = "000" ]; then
|
||||
warn "Cannot reach TD WebServer DAT at $TD_URL"
|
||||
info "Make sure TouchDesigner is running with mcp_webserver_base.tox imported"
|
||||
else
|
||||
warn "TD WebServer DAT returned HTTP $HTTP_CODE at $TD_URL"
|
||||
fi
|
||||
else
|
||||
warn "curl not found — cannot test TD connection"
|
||||
fi
|
||||
|
||||
# 6. Check Hermes config
|
||||
echo "6. Hermes MCP config"
|
||||
CONFIG_FILE="$HERMES_HOME/config.yaml"
|
||||
if [ -f "$CONFIG_FILE" ]; then
|
||||
if grep -q "touchdesigner" "$CONFIG_FILE" 2>/dev/null; then
|
||||
pass "TouchDesigner MCP server configured in config.yaml"
|
||||
else
|
||||
warn "No 'touchdesigner' entry found in mcp_servers config"
|
||||
info "Add a touchdesigner entry under mcp_servers: in $CONFIG_FILE"
|
||||
info "See references/mcp-tools.md for the configuration block"
|
||||
fi
|
||||
else
|
||||
warn "No Hermes config.yaml found at $CONFIG_FILE"
|
||||
fi
|
||||
|
||||
# Summary
|
||||
echo ""
|
||||
echo "=============================="
|
||||
if [ $ERRORS -eq 0 ]; then
|
||||
echo -e "${GREEN}All critical checks passed!${NC}"
|
||||
echo ""
|
||||
echo "Next steps:"
|
||||
echo " 1. Open TouchDesigner and import mcp_webserver_base.tox"
|
||||
echo " 2. Add the MCP server config to Hermes (see references/mcp-tools.md)"
|
||||
echo " 3. Restart Hermes and test: 'Get TouchDesigner server info'"
|
||||
else
|
||||
echo -e "${RED}$ERRORS critical issue(s) found.${NC}"
|
||||
echo "Fix the issues above, then re-run this script."
|
||||
fi
|
||||
echo ""
|
||||
Loading…
Add table
Add a link
Reference in a new issue