mirror of
https://github.com/kennethreitz/rhymepad.org.git
synced 2026-06-11 17:08:33 +00:00
kennethreitz
69b8ab4e93
- mode=syn now served locally by NLTK WordNet (already a g2p-en dep), sense-grouped by part of speech and frequency-ranked; Datamuse gone - Double-clicking a word in the draft opens its definition card; the card grew a Rhymes button for the old jump - NLTK wordnet data baked into the Docker image and CI Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
42 lines
1.5 KiB
Markdown
42 lines
1.5 KiB
Markdown
# RhymePad
|
|
|
|
A scratchpad for poets & rappers. Write in the pad; rhymes are detected
|
|
phonetically (CMU Pronouncing Dictionary) and color-coded as you type —
|
|
end rhymes, **internal rhymes**, and slant rhymes included. Comes with a
|
|
rhyme/synonym lookup, draggable stanza reordering, and synthesized beats
|
|
with adjustable tempo.
|
|
|
|
## Run
|
|
|
|
```console
|
|
$ uv run uvicorn app:app --reload
|
|
```
|
|
|
|
Then open <http://127.0.0.1:8000>.
|
|
|
|
## How rhyme detection works
|
|
|
|
- Every word is mapped to its CMU phonemes (`pronouncing`), with
|
|
lyric-friendly fallbacks (`runnin'` → `running`, possessives, and a
|
|
spelling heuristic for made-up words).
|
|
- **Perfect rhymes** share everything from the last stressed vowel on
|
|
(`tonight` / `light` / `flight` → `AY T`). These are matched anywhere
|
|
in a line — that's the internal rhyme detection.
|
|
- **Slant rhymes** share just the vowel sounds from the last stressed
|
|
vowel (`hold` / `coal`). Applied to line endings that didn't find a
|
|
perfect match.
|
|
- Same color = same sound. Underline = line-ending rhyme (the stanza's
|
|
a/b/a/b scheme); soft glow only = internal rhyme.
|
|
|
|
## API
|
|
|
|
- `POST /api/analyze` `{"text": "..."}` → token spans, rhyme groups,
|
|
per-stanza schemes, per-line meter
|
|
- `GET /api/lookup?word=light&mode=rhyme|near|syn` → frequency-ranked
|
|
rhymes / near rhymes (by syllable count) and WordNet synonyms (by
|
|
part of speech)
|
|
|
|
Dictionary definitions in the UI come from the free
|
|
[dictionaryapi.dev](https://dictionaryapi.dev/); everything else is
|
|
served locally.
|