Upload README.md with huggingface_hub

README.md

@@ -13,15 +13,15 @@ tags:
 pipeline_tag: text-to-speech
 ---
 
-# Kokoro Grounded Documentary Voiceover Model
+# Kokoro Grounded Documentary Voiceover Model (v2.0)
 
-A broadcast-grade text-to-speech engine powered by **Kokoro-ONNX**, featuring the **Grounded Documentary** voice profile (55% `bm_george` + 45% `bm_daniel`, British RP).
+A broadcast-grade text-to-speech engine powered by **Kokoro-ONNX**, featuring the **Grounded Documentary v2.0** voice profile (60% `bm_george` + 25% `bm_lewis` + 15% `bm_daniel`, British RP).
 
-Tuned specifically for long-form documentary, philosophical, and educational narration with:
-1. **Deliberate Pacing**: Unhurried speed (`0.92`), natural sentence pauses (`0.42s`), and extended pauses (`1.25s–1.35s`) across major thematic shifts.
-2. **Grounded Tone**: Deep, comforting lower-mid chest resonance preventing listening fatigue over long sessions.
-3. **Subtle Modulation**: Narrative emphasis carried via pitch inflection rather than jarring volume spikes.
-4. **Targeted De-Essing & Mastering**: Built-in broadcast mastering chain cutting harsh sibilance on high frequencies ('s', 'sh') with EBU R128 (-16 LUFS) loudness normalization.
+Calibrated based on multimodal acoustic analysis for prestigious documentary, philosophical, and cosmological narration:
+1. **Calibrated Baritone Tone**: Blends `bm_lewis` with `bm_george` to infuse authoritative sub-chest warmth and remove upper-mid nasal fatigue.
+2. **Contemplative Sage Pacing**: Unhurried speed (`0.91`), meditative sentence pauses (`0.65s`), clause pauses (`0.30s`), and extended pauses (`1.1s–1.3s`) across major thematic transitions.
+3. **Vedic & Sanskrit Pronunciation Lexicon**: Built-in phonetic dictionary (`pronunciation.py`) accurately pronouncing ancient Sanskrit and mythological terms (e.g., *Rsis*, *Ekam Sat*, *Nasadiya Sukta*, *Yajnavalkya*, *Rta*, *Brahman*, *Atman*).
+4. **Broadcast Mastering Filter**: Single-pass FFmpeg chain featuring optical-style soft-knee compression, surgical de-essing, boxiness notch, and EBU R128 (-16 LUFS) loudness normalization.
 
 ---
 
@@ -53,10 +53,10 @@ text = "Look up at the night sky... To you, it might look like an endless ocean
 audio, sr = kokoro.create(
     text,
     voice=voice_style,
-    speed=0.92,
+    speed=0.91,
     lang="en-gb",
-    sentence_pause=0.42,
-    clause_pause=0.20
+    sentence_pause=0.65,
+    clause_pause=0.30
 )
 
 sf.write("output.wav", audio, sr)
@@ -65,23 +65,21 @@ print(f"Generated {len(audio)/sr:.2f}s of broadcast narration!")
 
 ---
 
-## Broadcast Mastering Chain (FFmpeg)
+## Gemini-Calibrated Broadcast Mastering Chain (FFmpeg)
 
-For broadcast-grade warmth and smooth de-essing matching YouTube documentary standards:
+For broadcast-grade warmth, optical-style compression, and smooth de-essing matching YouTube documentary standards:
 
 ```bash
 ffmpeg -y -i output.wav -af \
-  "highpass=f=80,\
-   equalizer=f=160:t=q:w=1.0:g=2.8,\
-   equalizer=f=260:t=q:w=1.2:g=2.0,\
-   equalizer=f=450:t=q:w=2.0:g=-2.0,\
-   equalizer=f=3200:t=q:w=2.0:g=-1.6,\
-   equalizer=f=5800:t=q:w=2.5:g=-3.5,\
+  "highpass=f=75:p=2,\
+   equalizer=f=180:t=q:w=1.2:g=3.2,\
+   equalizer=f=480:t=q:w=2.0:g=-1.8,\
+   equalizer=f=3200:t=q:w=1.5:g=1.2,\
    equalizer=f=7200:t=q:w=2.5:g=-3.0,\
    lowpass=f=11000,\
-   deesser=i=0.45:m=0.5:f=0.55:s=o,\
-   compand=attacks=0.03:decays=0.3:points=-80/-80|-35/-25|-16/-13|0/-3,\
-   loudnorm=I=-16:TP=-1.5:LRA=8.5" \
+   deesser=i=0.7:m=0.5:f=0.65:s=o,\
+   compand=attacks=0.02:decays=0.25:points=-70/-70|-45/-32|-20/-14|0/-6:soft-knee=6,\
+   loudnorm=I=-16:TP=-1.5:LRA=9" \
   -c:a libmp3lame -b:a 192k output_mastered.mp3
 ```
 
@@ -91,4 +89,6 @@ ffmpeg -y -i output.wav -af \
 * `kokoro-v1.0.onnx`: Kokoro ONNX model weights (310 MB).
 * `voices-v1.0.bin`: Kokoro voice library (27 MB).
 * `grounded_documentary.npy`: Pre-blended float32 voice embedding vector (510 KB).
-* `narrator.py`: Self-contained Python helper script for single-command generation.
+* `narrator.py`: Voiceover narrator class with built-in mastering chain.
+* `pronunciation.py`: Vedic, Sanskrit, and ancient term phonetic lexicon.
+