Add connective prose to homepage — warm but concise

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) <noreply@anthropic.com>
This commit is contained in:
2026-03-25 20:53:20 -04:00
parent aa9d4282c9
commit 866065d7d7
+16 -1
View File
@@ -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 <https://claude.ai/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