n8n-nodes-thiri

An n8n community node for the THIRI Chord Intelligence API — deterministic, theory-aware chord analysis, voicing, reharmonization, and band arrangement.

Operations

| Operation | Endpoint | Returns | |---|---|---| | Analyze Chord | POST /v2/analyze | root, quality, intervals, Roman numeral, harmonic function | | Resolve Chord | POST /v2/resolve | spelled notes, MIDI, frequencies, recommended scales | | Generate Voicing | POST /v2/voicing | voiced notes + MIDI (+ voiceLeadingScore with previous notes) | | Reharmonize | POST /v2/reharmonize | alternative progressions across 8 techniques | | Conduct (Arrange Band) | POST /v2/conduct | 4-lane arrangement: conductor, lanes, leadSheet, midiBase64 |

Credentials

THIRI API credential: paste an API key (sk_live_…) — create one at build.thiri.ai/keys. Auth is Authorization: Bearer <key>. The credential Test button hits the public /health endpoint.

Install

n8n Cloud / self-hosted (UI): Settings → Community Nodes → Install → n8n-nodes-thiri.

Self-hosted (manual / private build):

npm install            # in this package
npm run build          # → dist/
# then either publish to npm, or mount dist via N8N_CUSTOM_EXTENSIONS

Notes

• Chord symbols are standard: Cmaj7 · Dm7b5 · G7#11 · C/G. Output is deterministic (cacheable).
• Reharmonize → Progression and Voicing → Previous Notes are pipe / comma separated and split into arrays for you.
• Read-only music intelligence — no side effects. 429 = rate/quota (builder tier: 300 rpm / 50k mo).
• Works as an AI Agent tool (usableAsTool), so an n8n Agent can call THIRI directly.

Build / develop

npm install
npm run build      # tsc → dist + copies the icon
npm run typecheck  # tsc --noEmit
npm run lint       # eslint-plugin-n8n-nodes-base (verified-registry rules)

MIT · Blues Prince Media · [email protected]