From 866065d7d7250f4cf7cb99dae693d52516ad459b Mon Sep 17 00:00:00 2001 From: Kenneth Reitz Date: Wed, 25 Mar 2026 20:53:20 -0400 Subject: [PATCH] =?UTF-8?q?Add=20connective=20prose=20to=20homepage=20?= =?UTF-8?q?=E2=80=94=20warm=20but=20concise?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Brief intro paragraph, theory/composition section intros, pytheory demo context. Enough personality without the wall of text. Co-Authored-By: Claude Opus 4.6 (1M context) --- docs/index.rst | 17 ++++++++++++++++- 1 file changed, 16 insertions(+), 1 deletion(-) diff --git a/docs/index.rst b/docs/index.rst index 041f4e9..4ed3cf7 100644 --- a/docs/index.rst +++ b/docs/index.rst @@ -4,6 +4,12 @@ PyTheory: Music Theory for Humans **PyTheory** is a Python library for exploring music theory, composing multi-part arrangements, and exporting them to MIDI for your DAW. +Use it to learn theory by doing — build chords from intervals and hear +the result. Use it to sketch song ideas faster than clicking through a +DAW. Use it with `Claude Code `_ to prototype +music from natural language. Or just use it to answer "what chords are +in G major?" without opening a browser. + :: $ pip install pytheory @@ -11,6 +17,10 @@ multi-part arrangements, and exporting them to MIDI for your DAW. Theory ------ +The theory layer works everywhere Python runs — no audio setup needed. +Tones, scales, chords, keys, intervals, harmony, 6 musical systems, +25 instruments: + .. code-block:: pycon >>> from pytheory import Key, Chord, Tone @@ -30,6 +40,10 @@ Theory Composition ----------- +When you're ready to make noise, the composition layer adds drums, +synths, effects, and multi-part arrangements. Sketch an idea, hear +it through your speakers, export MIDI, finish in your DAW: + .. code-block:: python from pytheory import Score, Pattern, Key, Duration, Chord @@ -50,7 +64,8 @@ Composition play_score(score) score.save_midi("sketch.mid") -:: +Or hear a randomly generated track from the command line — different +every time:: $ pytheory demo