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