Litany Engine

A generative audio ritual tool that turns arbitrary text corpora into haunting call-and-response ceremonies.

Inspired by The Thunder, Perfect Mind (Nag Hammadi Gnostic text) and surreal paradox poetry.

Features ElevenLabs voices, stereo panning with drift, background drone, and optional real cathedral convolution reverb.

Features

• Archetypal word mining (PMI + Zipf + optional spaCy/WordNet/Gensim)
• Surreal phrase generation ("A lantern drowned inside a whisper.")
• Alternating British voices (Officiant ↔ Congregation)
• Soft echo, low drone, gentle panning with per-line drift
• Real FFT-based convolution reverb with any impulse response
• Graceful degradation — works even with zero extra dependencies

Quick start

# 1. Generate phrases
python charged_words_generator.py --corpus ./my_poetry --phrases 80

# 2. Render the ritual
ELEVEN_API_KEY=sk-... python litany_to_elevenlabs.py \
  --voice-a 21m00... \
  --voice-b pNIn... \
  --in ./corpus/phrases.txt \
  --out my_ceremony.mp3 \
  --echo --drone --pan-a -0.65 --pan-b 0.65 --drift 0.25 \
  --ir ./impulses/cathedral.wav --wet 0.4