raganotate 0.6.8

Full-Stack Carnatic Music Notation Engine — Lyrics to Playable Audio

raganotate

Python library for RagaNotate — parse, encode, and export Carnatic music notation with Just Intonation tuning, gamaka feature vectors, and tala awareness.

Part of the RagaNotate ecosystem (Electron desktop app · TypeScript library · this Python library — one canonical notation format).

Install

pip install raganotate            # core — zero dependencies, pure stdlib
pip install raganotate[midi]      # + MIDI export (MIDIUtil)
pip install raganotate[ai]        # + HuggingFace dataset encoding
pip install raganotate[all]       # everything except large models

Usage

from raganotate import parse
from raganotate.swara import swara_hz
from raganotate.tala import get_tala

nodes = parse("| S R G M | P D N S' |")
hz = swara_hz("G", octave="madhya", sa_hz=240.0)   # JI frequency, Sa = 240 Hz
tala = get_tala("Misra Chapu")                      # 7 aksharas (3+4)

Modules

Module	Purpose
parser	ASCII notation → node objects
swara	16 swarasthanas, JI frequency engine
gamaka	Gamaka types + ML feature vectors
tala	Suladi Sapta + Chapu talas, beat clock
raga_grammar	Raga scale validation
midi_generator	MIDI export with JI pitch bends
ai_encoder	Notation → AI-ready token sequences
lyrics_mapper	Lyrics ↔ notation syllable alignment

Notation format

See SPEC.md for the full standard: 16 swarasthanas, octave markers (.s / S / S'), duration markers (; : ::), gamaka symbols (~ ^ v *), and tala angas.

License

AGPL-3.0-or-later — see LICENSE.