docs: update README - reflect Qwen3-TTS, voice-first Q&A, all current features

README.md

@@ -9,49 +9,64 @@ app_file: app.py
 pinned: false
 ---
 
-# ReadBookMom
+# MomsVoice
 
 **A parent records their voice. A bedtime story plays in that voice. The child can ask questions and hear answers — all in mom or dad's voice.**
 
 Built for the Hugging Face Hackathon. Runs entirely on local models inside a Gradio app on Hugging Face Spaces — no external APIs, no data leaves the server.
 
-## Demo
+🔗 **Live Demo:** [https://huggingface.co/spaces/DrSquare/MomsVoice](https://huggingface.co/spaces/DrSquare/MomsVoice)
+
+## Demo Flow
 
 ```
 🎤 Record 15s of your voice → 📖 Pick a story → ▶️ Story plays in your voice
                                                        ↓
-                                    ❓ Child taps Ask → Story pauses
+                                    ❓ Child taps Ask → Story pauses, mic auto-starts
                                                        ↓
-                                    Child asks a question → Hears answer in your voice
+                                    Child asks a question → Answer auto-plays in narrator's voice
                                                        ↓
-                                              ▶️ Story resumes
+                                              ↩️ Resume → Story continues from where it paused
 ```
 
 ## How It Works
 
 | Step | What Happens | Model |
 |---|---|---|
-| **Clone** | Parent records or uploads 15–30s of audio. Speaker embedding is extracted and cached server-side. | Qwen3-TTS-1.7B |
-| **Listen** | Story plays in the cloned voice as interruptible sentence chunks. Falls back to Supertonic stock voice if no clone. | Qwen3-TTS-1.7B / Supertonic |
-| **Ask** | Child taps Ask, narration pauses, child types or speaks a question. | Whisper-small (ASR, on-demand) |
-| **Answer** | A short grounded answer is generated from the story context and spoken in the cloned voice. | Qwen2.5-3B-Instruct + Qwen3-TTS-1.7B |
-| **Resume** | Story continues from where it left off. | Cached chunks |
+| **Clone** | Parent records or uploads 15–30s of audio. Speaker embedding is extracted and cached. | Qwen3-TTS-1.7B Base |
+| **Listen** | Story plays in the cloned voice as interruptible sentence chunks. Falls back to CustomVoice 0.6B stock voice (speaker "vivian") if no clone. | Qwen3-TTS-1.7B / CustomVoice 0.6B |
+| **Ask** | Child taps Ask → narration pauses, microphone auto-starts. When recording stops, question is transcribed and answer auto-generates. | Whisper-small (ASR) |
+| **Answer** | A short grounded answer is generated from the full story context and spoken in the narrator's voice. Auto-plays immediately. | Qwen2.5-3B-Instruct + Qwen3-TTS |
+| **Resume** | Story continues from where it left off. Play also pauses on tab switch. | Cached chunks |
 
 ## Models
 
 | Model | Role | Size |
 |---|---|---|
 | [Qwen3-TTS-1.7B-Base](https://huggingface.co/Qwen/Qwen3-TTS-12Hz-1.7B-Base) | Zero-shot voice cloning + TTS | 1.7B params |
-| [Supertonic TTS](https://huggingface.co/niclas-pham/supertonic-3) | Fast stock-voice TTS fallback | ONNX model |
-| [Qwen2.5-3B-Instruct](https://huggingface.co/Qwen/Qwen2.5-3B-Instruct) | Story Q&A | 3B params (4-bit on T4) |
-| [Whisper-small](https://huggingface.co/openai/whisper-small) | Child speech-to-text | 244M params (loaded on demand) |
+| [Qwen3-TTS-0.6B-CustomVoice](https://huggingface.co/Qwen/Qwen3-TTS-12Hz-0.6B-CustomVoice) | Fast stock-voice TTS (predefined speakers) | 0.6B params |
+| [Qwen2.5-3B-Instruct](https://huggingface.co/Qwen/Qwen2.5-3B-Instruct) | Story Q&A (context-grounded answers) | 3B params |
+| [Whisper-small](https://huggingface.co/openai/whisper-small) | Child speech-to-text | 244M params |
+
+All models are preloaded at startup for fast response times.
 
 ## Tech Stack
 
-- **UI:** Gradio 5.x + gr.Server (custom CSS/JS for Google Stitch-inspired design)
-- **Runtime:** Single `app.py` process on HF Spaces (T4 or A10G GPU)
+- **UI:** Gradio 5.35.0 with custom CSS/JS (Google Stitch-inspired warm design)
+- **Runtime:** Single `app.py` process on HF Spaces (GPU: A10G or larger recommended)
 - **Stories:** 10 public domain `.txt` files (downloaded and cleaned from Project Gutenberg)
-- **Storage:** In-memory session cache (no database)
+- **Storage:** In-memory session cache + disk-persisted voice profiles (`Voice_Profile/`)
+- **TTS Backends:** Qwen3-TTS Base (cloned voice) + CustomVoice 0.6B (stock fallback)
+
+## Features
+
+- 🎤 **Voice Cloning** — Record 15s, get a narrator that sounds like you
+- 📚 **Explore & Library** — Browse and select stories with clickable book cards
+- ▶️ **Chunked Streaming** — Stories play paragraph-by-paragraph with real-time highlighting
+- ❓ **Voice Q&A** — Ask questions about the story; auto-submit on recording stop, autoplay answer
+- ⏸ **Smart Pause** — Playback pauses on Ask, tab switch (Explore/Clone Studio), or Pause button
+- 🎙️ **Voice Selection** — Click voice cards to switch between cloned narrators
+- 💾 **Persistent Profiles** — Cloned voices survive app restarts
 
 ## Quick Start (Local Dev)
 
@@ -66,22 +81,23 @@ python app.py
 ## Project Structure
 
 ```
-├── app.py                  # Main Gradio app (UI + wiring)
-├── voice_clone.py          # Qwen3-TTS voice cloning + profile cache
-├── tts.py                  # Unified TTS interface (Qwen3 or Supertonic)
-├── inference.py            # ASR (Whisper) + Q&A (Qwen2.5-3B-Instruct)
-├── requirements.txt        # Python deps
+├── app.py                  # Main Gradio app (UI + all event wiring)
+├── voice_clone.py          # Qwen3-TTS voice cloning + profile persistence
+├── tts.py                  # Unified TTS interface (Base cloned + CustomVoice stock)
+├── inference.py            # ASR (Whisper-small) + Q&A (Qwen2.5-3B-Instruct)
+├── requirements.txt        # Python deps (gradio, qwen-tts, transformers, torch)
 ├── stories/                # 10 cleaned public domain story texts (TTS-ready)
 ├── story_downloader/       # Story acquisition & cleaning pipeline
 │   ├── gutenberg_downloader.py  # Reusable Project Gutenberg downloader/parser
 │   ├── download_stories.py      # Downloads 10 children's stories
 │   └── clean_stories.py         # Strips Gutenberg boilerplate for TTS
-├── static/                 # Custom CSS/JS for Stitch-style UI
+├── static/style.css        # Custom CSS for warm storybook UI
 ├── assets/covers/          # Story cover images
+├── Voice_Profile/          # Persisted cloned voice profiles
 ├── test_modules/           # Component and integration tests
 ├── mission.md              # Product vision
 ├── sprint.md               # 2-day hackathon sprint plan
-├── tech_stack.md            # Technical architecture
+├── tech_stack.md           # Technical architecture
 └── future_mobile_app_considerations.md  # Mobile deployment guidance
 ```
 
@@ -100,19 +116,20 @@ python app.py
 | The Sleeping Beauty | 1,783 | Traditional |
 | The Adventures of Puss in Boots | 503 | Traditional (verse) |
 
-All stories are public domain from [Project Gutenberg](https://www.gutenberg.org/). Each file uses a simple format: title on line 1, blank line, then story prose — ready for direct TTS consumption.
+All stories are public domain from [Project Gutenberg](https://www.gutenberg.org/).
 
 ## Key Design Decisions
 
 - **All local inference** — voice, Q&A, and ASR run on the Space GPU. No external APIs.
-- **Interruptible chunked streaming** — paragraphs synthesized and played one at a time for fast start and clean pause/resume.
-- **Pre-generated Q&A** — anticipated questions are generated in the background during narration for sub-1s response on cache hits.
-- **Button-based interruption** — tap Ask to pause. No always-listening mic (privacy + complexity).
-- **Privacy-first** — no audio leaves the server, no user accounts, no database.
+- **Interruptible chunked streaming** — sentences synthesized and played one at a time for fast start and clean pause/resume.
+- **Voice-first Q&A** — microphone auto-starts on Ask; answer auto-plays when ready. No manual button clicks needed.
+- **Full story context** — Q&A uses the entire story (or top-5 relevant paragraphs for long stories) plus current position for grounded answers.
+- **Smart pause** — playback pauses on Ask, tab switch, or Pause button. Resume continues from exact position.
+- **Privacy-first** — no audio leaves the server, no user accounts, no external database.
 
 ## Privacy
 
-All inference runs on the Hugging Face Space GPU. Voice samples, story text, and generated audio stay on the server runtime and are not persisted after the session ends. No external APIs are called.
+All inference runs on the Hugging Face Space GPU. Voice samples, story text, and generated audio stay on the server runtime. Voice profiles are saved to the Space's persistent storage but no data is sent to external services.
 
 ## License