thiri

n8n community node for the THIRI Chord Intelligence API — analyze, resolve, voice, reharmonize, and conduct chords (deterministic music theory).

Package Information

Released: 4 mo ago
Downloads: 14 weekly / 151 monthly
Latest Version: 0.1.0
Author: Blues Prince Media

Documentation

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 · chords@thiri.ai

Discussion