kennethreitz/pytheory

Health v2 · maintenance only

Adoption not part of the score

1637 stars · 83 forks observed · 2026-08-28

What it is AI-extracted, prompt v1, taxonomy v1, 2026-08-30, confidence not recorded

PyTheory is a Python library for exploring music theory (tones, scales, chords, keys, intervals, harmony) and composing multi-part arrangements with drums, synths, and effects. It can play audio live, export to MIDI/WAV/MusicXML/tab, tune instruments, transcribe recordings, and is drivable from a Claude Code plugin.

Use cases

• explore scales chords and chord progressions in python
• sketch a song with drums bass and synth parts and export midi
• identify chords and intervals from note names or chord symbols
• get guitar chord fingerings scale diagrams and nashville number charts
• tune a guitar with a real-time strobe tuner
• transcribe a hummed melody into midi or sheet music
• compose music from natural language with claude code

When to choose

• you want to learn or apply music theory programmatically in python
• you want to sketch multi-part arrangements in code and export midi without a daw
• you need guitar fingerings, tablature, or tuning tools without ad-filled websites

When to avoid

• you need professional notation engraving or a full DAW production environment
• you work primarily with non-western tuning systems beyond its supported set
• you need a graphical sequencer rather than a code-first workflow

Facets

library · maturity active

audio-processing sdk developer-tools audio education media developer-tools python cross-platform cli music-theory midi composition chords scales synthesis guitar audio-playback claude-plugin tuner web

Member repositories

For agents

markdown · JSON · MCP: product_card(name="kennethreitz/pytheory")