Update app.py

.gitattributes

@@ -1,7 +1,35 @@
-*.png filter=lfs diff=lfs merge=lfs -text
-*.jpg filter=lfs diff=lfs merge=lfs -text
-*.jpeg filter=lfs diff=lfs merge=lfs -text
-*.wav filter=lfs diff=lfs merge=lfs -text
-*.mp3 filter=lfs diff=lfs merge=lfs -text
-*.gif filter=lfs diff=lfs merge=lfs -text
-*.webp filter=lfs diff=lfs merge=lfs -text
+*.7z filter=lfs diff=lfs merge=lfs -text
+*.arrow filter=lfs diff=lfs merge=lfs -text
+*.bin filter=lfs diff=lfs merge=lfs -text
+*.bz2 filter=lfs diff=lfs merge=lfs -text
+*.ckpt filter=lfs diff=lfs merge=lfs -text
+*.ftz filter=lfs diff=lfs merge=lfs -text
+*.gz filter=lfs diff=lfs merge=lfs -text
+*.h5 filter=lfs diff=lfs merge=lfs -text
+*.joblib filter=lfs diff=lfs merge=lfs -text
+*.lfs.* filter=lfs diff=lfs merge=lfs -text
+*.mlmodel filter=lfs diff=lfs merge=lfs -text
+*.model filter=lfs diff=lfs merge=lfs -text
+*.msgpack filter=lfs diff=lfs merge=lfs -text
+*.npy filter=lfs diff=lfs merge=lfs -text
+*.npz filter=lfs diff=lfs merge=lfs -text
+*.onnx filter=lfs diff=lfs merge=lfs -text
+*.ot filter=lfs diff=lfs merge=lfs -text
+*.parquet filter=lfs diff=lfs merge=lfs -text
+*.pb filter=lfs diff=lfs merge=lfs -text
+*.pickle filter=lfs diff=lfs merge=lfs -text
+*.pkl filter=lfs diff=lfs merge=lfs -text
+*.pt filter=lfs diff=lfs merge=lfs -text
+*.pth filter=lfs diff=lfs merge=lfs -text
+*.rar filter=lfs diff=lfs merge=lfs -text
+*.safetensors filter=lfs diff=lfs merge=lfs -text
+saved_model/**/* filter=lfs diff=lfs merge=lfs -text
+*.tar.* filter=lfs diff=lfs merge=lfs -text
+*.tar filter=lfs diff=lfs merge=lfs -text
+*.tflite filter=lfs diff=lfs merge=lfs -text
+*.tgz filter=lfs diff=lfs merge=lfs -text
+*.wasm filter=lfs diff=lfs merge=lfs -text
+*.xz filter=lfs diff=lfs merge=lfs -text
+*.zip filter=lfs diff=lfs merge=lfs -text
+*.zst filter=lfs diff=lfs merge=lfs -text
+*tfevents* filter=lfs diff=lfs merge=lfs -text

.gitignore

@@ -1 +0,0 @@
-__pycache__/

README.md

@@ -1,11 +1,14 @@
 ---
-title: ReadBookMom
-emoji: 📖
-colorFrom: yellow
-colorTo: green
+title: Gradio Practice
+emoji: ⚡
+colorFrom: green
+colorTo: blue
 sdk: gradio
-sdk_version: "5.35.0"
-python_version: "3.10"
+sdk_version: 6.16.0
+python_version: '3.13'
 app_file: app.py
 pinned: false
+short_description: gradio_frontend_practice
 ---
+
+Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference

SPEC.md

@@ -1,103 +0,0 @@
-# ReadBookMom
-
-**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
-
-```
-🎤 Record 15s of your voice → 📖 Pick a story → ▶️ Story plays in your voice
-                                                       ↓
-                                    ❓ Child taps Ask → Story pauses
-                                                       ↓
-                                    Child asks a question → Hears answer in your voice
-                                                       ↓
-                                              ▶️ Story resumes
-```
-
-## How It Works
-
-| Step | What Happens | Model |
-|---|---|---|
-| **Clone** | Parent records or uploads 15–30s of audio. Voice representation is computed and cached. | QWEN-TTS-0.6B |
-| **Listen** | Story plays in the cloned voice as interruptible paragraph chunks. | QWEN-TTS-0.6B |
-| **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 + QWEN-TTS-0.6B |
-| **Resume** | Story continues from where it left off. | Cached chunks |
-
-## Models
-
-| Model | Role | Size |
-|---|---|---|
-| [QWEN-TTS-0.6B](https://huggingface.co/Qwen/Qwen-TTS-0.6B) | Voice cloning + TTS | 0.6B params |
-| [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) |
-
-## 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)
-- **Stories:** 10 public domain `.txt` files (downloaded and cleaned from Project Gutenberg)
-- **Storage:** In-memory session cache (no database)
-
-## Quick Start (Local Dev)
-
-```bash
-git clone https://github.com/MomsVoiceAI/HuggingFace_Hack.git
-cd HuggingFace_Hack
-pip install gradio transformers torch accelerate bitsandbytes soundfile numpy
-python app.py
-# → http://localhost:7860
-```
-
-## Project Structure
-
-```
-├── app.py                  # Main Gradio app
-├── requirements.txt        # Python deps
-├── 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
-├── assets/covers/          # Story cover images
-├── mission.md              # Product vision
-├── sprint.md               # 2-day hackathon sprint plan
-├── tech_stack.md            # Technical architecture
-└── future_mobile_app_considerations.md  # Mobile deployment guidance
-```
-
-## Stories Included
-
-| Story | Words | Source |
-|---|---|---|
-| The Tale of Peter Rabbit | 948 | Beatrix Potter |
-| The Tale of Benjamin Bunny | 1,118 | Beatrix Potter |
-| The Tale of Jemima Puddle-Duck | 1,245 | Beatrix Potter |
-| The Tale of Tom Kitten | 691 | Beatrix Potter |
-| The History of Tom Thumb | 2,912 | Traditional |
-| The Story of the Three Little Pigs | 956 | Traditional |
-| The Little Red Hen | 1,295 | Traditional |
-| The Little Gingerbread Man | 1,823 | Traditional |
-| 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.
-
-## 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.
-
-## 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.
-
-## License
-
-Hackathon project. Stories are public domain.

app.py

@@ -1,948 +1,576 @@
-import os
-import math
-import struct
-import wave
 import gradio as gr
 import time
-from pathlib import Path
+import random
 
-from tts import split_into_chunks, generate_audio_stream
-
-# Create directories for sample audio files
-os.makedirs("sample_sounds", exist_ok=True)
-
-# Generate relaxing audio chime waveforms procedurally
-# This runs fully client/server-side with standard Python, eliminating mock limits or Torch wait times
-def generate_chimes_wav(filename, duration=120, melody_type="lullaby"):
-    sample_rate = 16000
-    n_samples = int(duration * sample_rate)
-
-    with wave.open(filename, 'wb') as wav_file:
-        wav_file.setnchannels(1)
-        wav_file.setsampwidth(2)
-        wav_file.setframerate(sample_rate)
-
-        # Pentatonic cozy scales
-        if melody_type == "lullaby":
-            notes = [261.63, 293.66, 329.63, 392.00, 440.00] # C4, D4, E4, G4, A4
-        elif melody_type == "adventure":
-            notes = [196.00, 246.94, 293.63, 329.63, 392.00] # G3, B3, D4, E4, G4
-        else:
-            notes = [220.00, 261.63, 293.66, 329.63, 392.00] # A3, C4, D4, E4, G4
-
-        for i in range(n_samples):
-            # cycle notes based on melody speed
-            note_speed = sample_rate * 1.5 if melody_type == "lullaby" else sample_rate * 1.2
-            note_idx = int((i / note_speed) % len(notes))
-            freq = notes[note_idx]
-
-            # envelope to prevent crackles
-            sample_in_note = i % int(note_speed)
-            envelope = 1.0
-            if sample_in_note < 1200: # attack
-                envelope = sample_in_note / 1200
-            else: # decay
-                decay_length = note_speed - 1200
-                envelope = max(0.0, 1.0 - (sample_in_note - 1200) / decay_length)
-
-            # Synthesize voice-harmonic chime
-            val = math.sin(2 * math.pi * freq * i / sample_rate)
-            val += 0.45 * math.sin(2 * math.pi * (freq * 1.5) * i / sample_rate)
-            val += 0.25 * math.sin(2 * math.pi * (freq * 2.0) * i / sample_rate)
-            val = val / 1.7 * envelope
-
-            packed_val = struct.pack('<h', int(val * 16384))
-            wav_file.writeframes(packed_val)
-
-# Instantiate the audio files immediately so they are hot in HF Spaces cache
-create_sound_library = {
-    "willow": ("sample_sounds/willow.wav", 120, "lullaby"),
-    "sky": ("sample_sounds/sky.wav", 180, "adventure"),
-    "deep": ("sample_sounds/deep.wav", 240, "adventure"),
-    "baker": ("sample_sounds/baker.wav", 98, "lullaby"),
-    "letters": ("sample_sounds/letters.wav", 156, "classic"),
-    "cloned_preview": ("sample_sounds/cloned_preview.wav", 15, "lullaby")
-}
-
-for key, (path, dur, mel) in create_sound_library.items():
-    if not os.path.exists(path):
-        generate_chimes_wav(path, duration=dur, melody_type=mel)
-
-COVERS_DIR = Path(__file__).parent / "assets" / "covers"
-
-def cover_path(slug: str) -> str:
-    p = COVERS_DIR / f"{slug}.png"
-    return f"/gradio_api/file={p.resolve().as_posix()}"
-
-def load_books_from_stories(stories_dir="stories"):
-    books = []
-    story_files = sorted(
-        f for f in os.listdir(stories_dir) if f.endswith(".txt")
-    ) if os.path.isdir(stories_dir) else []
-
-    for i, filename in enumerate(story_files):
-        title = filename.replace(".txt", "").replace("_", " ")
-        slug = filename.replace(".txt", "")
-        synopsis = ""
-        try:
-            with open(os.path.join(stories_dir, filename), encoding="utf-8") as f:
-                lines = [l.strip() for l in f.readlines() if l.strip()]
-                synopsis = " ".join(lines[1:4]) if len(lines) > 1 else lines[0] if lines else ""
-        except Exception:
-            pass
-
-        books.append({
-            "id": str(i + 1),
-            "title": title,
-            "author": "Public Domain",
-            "cover_url": cover_path(slug),
-            "voice_name": "Mom's Voice",
-            "duration": 0,
-            "elapsed_time": 0,
-            "synopsis": synopsis,
-            "category": "Children's Story",
-            "is_cloned": False,
-            "percentage": 0,
-            "audio_path": None,
-            "story_path": os.path.join(stories_dir, filename),
-        })
-    return books
-
-mock_books = load_books_from_stories()
-
-mock_voices = [
+# ==========================================
+# 0. 더미 데이터 정의 및 상상 속의 오디오 풀
+# ==========================================
+DUMMY_BOOKS = [
     {
-        "id": "v1",
-        "name": "Mom's Voice",
-        "avatar_url": "👩‍🦳",
-        "description": "Warm, soft, with a natural soothing cadence. Best for bedtime stories.",
-        "gender": "Female",
-        "created_date": "2026-06-01",
-        "status": "ready"
+        "id": "secret_garden",
+        "title": "The Secret Garden",
+        "author": "Frances Hodgson Burnett",
+        "category": "CLASSIC",
+        "narrator": "Mom's Voice",
+        "desc": "Nora Seed finds herself faced with the possibility of changing her life for a new one, following a different career, undoing old breakups, and finding a secret key to life.",
+        "progress": 65,
+        "time_left": "2시간 15분 남음",
+        "duration": "8시간 52분",
+        "cover": "https://images.unsplash.com/photo-1544947950-fa07a98d237f?auto=format&fit=crop&q=80&w=300"
     },
     {
-        "id": "v2",
-        "name": "Grandpa Joseph",
-        "avatar_url": "👴",
-        "description": "Deep, resonant, with an occasional comforting chuckle. Perfect for classic adventure stories.",
-        "gender": "Male",
-        "created_date": "2026-06-03",
-        "status": "ready"
+        "id": "starlight",
+        "title": "Starlight Chronicles",
+        "author": "Elara Vance",
+        "category": "ADVENTURE",
+        "narrator": "Mom's Voice",
+        "desc": "Set sail amongst the cosmic winds inside the spectacular starbound vessel. Join Captain Elara and her crew navigating wormholes and decode ancient celestial signals.",
+        "progress": 35,
+        "time_left": "4시간 10분 남음",
+        "duration": "6시간 30분",
+        "cover": "https://images.unsplash.com/photo-1512820790803-83ca734da794?auto=format&fit=crop&q=80&w=300"
     },
     {
-        "id": "v3",
-        "name": "Aunt Sarah",
-        "avatar_url": "👩",
-        "description": "Bubbly, expressive, brilliant at acting out funny character voices.",
-        "gender": "Female",
-        "created_date": "2026-06-06",
-        "status": "processing"
+        "id": "whispers",
+        "title": "Whispers of the Wind",
+        "author": "Thomas Thorne",
+        "category": "FANTASY",
+        "narrator": "Mom's Voice",
+        "desc": "Deep in the mythical forest, winds do not merely blow—They speak. Follow a young woodcarver who discovers he can decipher these celestial whispers.",
+        "progress": 90,
+        "time_left": "40분 남음",
+        "duration": "7시간 15분",
+        "cover": "https://images.unsplash.com/photo-1518709268805-4e9042af9f23?auto=format&fit=crop&q=80&w=300"
+    },
+    {
+        "id": "glass_hour",
+        "title": "The Glass Hour",
+        "author": "S. J. Watson",
+        "category": "MYSTERY",
+        "narrator": "Mom's Voice",
+        "desc": "An intricate, gripping mystery set against Victorian clock-making town. When the grand tower stops at 4:04, an impossible robbery is revealed.",
+        "progress": 100,
+        "time_left": "완독 완료",
+        "duration": "9시간 05분",
+        "cover": "https://images.unsplash.com/photo-1531988042231-d39a9cc12a9a?auto=format&fit=crop&q=80&w=300"
     }
 ]
 
-narrative_subtitles = [
-    "Deep within the heart of Whispering Woods stands an ancient willow tree...",
-    "It was rumored to hold the forgotten memories of the valley.",
-    "When a young cartographer is sent to map the region...",
-    "She starts hearing a gentle, familiar voice whispering from the emerald leaves.",
-    "The voice seemed to know her name, calling softly in the early autumn breeze...",
-    "And that was when she realized, she was not alone in the valley."
-]
-
-with open(os.path.join(os.path.dirname(__file__), "static", "style.css"), encoding="utf-8") as _f:
-    css_code = _f.read()
-
-def generate_dashboard_html(books_list):
-    featured = books_list[0]
-    others = books_list[1:]
-
-    html = f"""
-    <div style="margin-bottom: 24px;">
-        <span style="font-size: 11px; text-transform: uppercase; letter-spacing: 2px; color: #f5841f; font-weight: 600;">Welcome Back, Sarah</span>
-        <h2 class="serif-header" style="font-size: 28px; margin-top: 4px; margin-bottom: 16px;">Explore Your Warm Audiobook Shelves</h2>
-    </div>
-
-    <!-- Hero Spotlight Section -->
-    <div class="hero-spotlight" style="display: flex; flex-direction: row; gap: 32px; align-items: center; margin-bottom: 32px; flex-wrap: wrap;">
-        <div style="flex: 1; min-width: 200px; max-width: 280px; text-align: center;">
-            <img src="{featured['cover_url']}" style="width: 180px; height: 260px; object-fit: cover; border-radius: 16px; box-shadow: 0 8px 24px rgba(0,0,0,0.3); transform: rotate(-2deg);" referrerPolicy="no-referrer" />
-        </div>
-        <div style="flex: 2; min-width: 300px; display: flex; flex-direction: column; justify-content: space-between; gap: 16px;">
-            <div>
-                <span class="badge-featured" style="margin-bottom: 8px;">Featured Clone</span>
-                <h3 class="serif-header" style="color: white !important; font-size: 28px; margin: 4px 0;">{featured['title']}</h3>
-                <p style="color: #6f6257;">by <span style="font-style: italic; color: #ddc1b0;">{featured['author']}</span></p>
-                <p style="color: #cbd5e1; font-size: 13.5px; line-height: 1.6; margin-top: 8px;">{featured['synopsis']}</p>
-            </div>
-
-            <div style="display: flex; gap: 12px; flex-wrap: wrap; font-size: 12px; color: #e2e8f0;">
-                <span style="background: rgba(255,255,255,0.1); padding: 4px 10px; border-radius: 8px;">⏱️ 20 Min Remaining</span>
-                <span style="background: rgba(255,255,255,0.1); padding: 4px 10px; border-radius: 8px; font-weight: 600; color: #ffd3a6;">🎙️ Narrator: {featured['voice_name']}</span>
-                <span style="background: rgba(255,255,255,0.1); padding: 4px 10px; border-radius: 8px;">⭐ Editorial Spotlight</span>
-            </div>
-        </div>
-    </div>
-
-    <div>
-        <h4 class="serif-header" style="font-size: 20px; margin-bottom: 16px;">Continue Reading with Channeled Voices</h4>
-        <div class="book-shelf-grid">
-    """
-
-    for bk in books_list:
-        html += f"""
-        <div class="shelf-card">
-            <div>
-                <img src="{bk['cover_url']}" class="cover-image" referrerPolicy="no-referrer" />
-            </div>
-            <div style="display: flex; flex-direction: column; justify-content: space-between; flex: 1; min-width: 0;">
-                <div>
-                    <div style="display: flex; justify-content: space-between; font-size: 10px; font-weight: 700; color: #f5841f;">
-                        <span>{bk['category']}</span>
-                        <span>{bk['percentage']}%</span>
-                    </div>
-                    <h5 class="serif-header" style="font-size: 14px; margin: 4px 0; overflow: hidden; text-overflow: ellipsis; white-space: nowrap;">{bk['title']}</h5>
-                    <p style="font-size: 11.5px; color: #6f6257; margin-bottom: 8px;">by {bk['author']}</p>
-                </div>
-                <div>
-                    <div class="progress-bar-bg" style="margin-bottom: 6px;">
-                        <div class="progress-bar-fill" style="width: {bk['percentage']}%"></div>
-                    </div>
-                    <div style="display: flex; justify-content: space-between; font-size: 11px; color: #6f6257;">
-                        <span style="overflow: hidden; text-overflow: ellipsis; white-space: nowrap;">🎙️ {bk['voice_name']}</span>
-                    </div>
-                </div>
-            </div>
-        </div>
-        """
-
-    html += """
-        </div>
-    </div>
-    """
-    return html
+# UI 커스텀 폰트 및 아름다운 Warm Editorial 스타일링용 CSS 주입
+custom_theme_css = """
+@import url('https://fonts.googleapis.com/css2?family=Playfair+Display:ital,wght@0,600;0,700;1,400&family=Inter:wght@400;500;600;700&display=swap');
 
+body, .gradio-container {
+    background-color: #fcf9f4 !important;
+    font-family: 'Inter', system-ui, -apple-system, sans-serif !important;
+    color: #1c1c19 !important;
+}
 
-def generate_library_html(books_list, query="", category_filt="All", empty_mode=False):
-    if empty_mode:
-        return """
-        <div style="display: flex; flex-direction: column; align-items: center; justify-content: center; padding: 64px 16px; text-align: center; max-width: 440px; margin: 0 auto;">
-            <div style="position: relative; width: 90px; height: 90px; border-radius: 50%; background: #ede8e3; border: 1px dashed #ddc1b0; display: flex; align-items: center; justify-content: center; margin-bottom: 24px;">
-                <span style="font-size: 32px;">📚</span>
-                <span style="position: absolute; font-size: 20px; bottom: -4px; right: -4px;">🎙️</span>
-            </div>
-            <h3 class="serif-header" style="font-size: 22px; margin-bottom: 8px;">Your Bookshelf is Waiting to be Voiced</h3>
-            <p style="font-size: 13.5px; color: #6f6257; line-height: 1.5; margin-bottom: 24px;">
-                Choose a comforting companion, clone their warm voice, and hear any classical or modern tale come to life immediately.
-            </p>
-            <div style="display: flex; gap: 12px; width: 100%;">
-                <span style="flex: 1; padding: 12px; background: #944a00; color: white; border-radius: 12px; font-weight: 700; font-size: 13px;">Use 'Clone Voice' tab to craft a companion</span>
-            </div>
-        </div>
-        """
+/* Serif 헤딩 스타일링 */
+.editorial-title {
+    font-family: 'Playfair Display', Georgia, serif !important;
+    color: #1c1c19 !important;
+    font-weight: 700 !important;
+}
 
-    filtered = []
-    for bk in books_list:
-        match_query = (query.lower() in bk["title"].lower()) or (query.lower() in bk["author"].lower()) or (query.lower() in bk["voice_name"].lower())
-        match_cat = True
+.brand-text {
+    font-family: 'Playfair Display', Georgia, serif !important;
+    color: #944a00 !important;
+    font-weight: 700 !important;
+}
 
-        if category_filt == "In Progress":
-            match_cat = 0 < bk["percentage"] < 100
-        elif category_filt == "Completed":
-            match_cat = bk["percentage"] == 100
+/* 부드러운 카드 그림자 및 라운딩 효과 */
+.book-card-container {
+    background: #ffffff !important;
+    border: 1px solid rgba(221, 193, 176, 0.4) !important;
+    border-radius: 20px !important;
+    padding: 18px !important;
+    box-shadow: 0 10px 25px rgba(74, 63, 53, 0.04) !important;
+    transition: all 0.3s ease !important;
+}
 
-        if match_query and match_cat:
-            filtered.append(bk)
+.book-card-container:hover {
+    transform: translateY(-4px) !important;
+    box-shadow: 0 16px 32px rgba(148, 74, 0, 0.06) !important;
+}
 
-    if len(filtered) == 0:
-        return """
-        <div style="text-align: center; padding: 48px; border: 1px dashed #ebdccb; border-radius: 16px;">
-            <span style="font-size: 28px;">🔍</span>
-            <p style="font-size: 14px; color: #6f6257; margin-top: 8px;">No audiobooks match your search criteria.</p>
-        </div>
-        """
+/* 상부 태그 엠블럼 */
+.category-badge {
+    background: rgba(245, 132, 31, 0.1) !important;
+    color: #944a00 !important;
+    font-size: 10px !important;
+    font-weight: 700 !important;
+    padding: 3px 10px !important;
+    border-radius: 12px !important;
+    text-transform: uppercase !important;
+    letter-spacing: 0.05em !important;
+}
 
-    html = """<div class="book-shelf-grid">"""
-    for bk in filtered:
-        html += f"""
-        <div class="shelf-card group" style="flex-direction: column; gap: 0; padding: 0; overflow: hidden; cursor: pointer;" onclick="
-            var radios = document.querySelectorAll('.library-book-selector input[type=radio]');
-            radios.forEach(function(r) {{ if(r.value === '{bk['title']}') {{ r.click(); }} }});
-        ">
-            <div style="position: relative; aspect-ratio: 3/4; overflow: hidden; height: 200px;">
-                <img src="{bk['cover_url']}" style="width: 100%; height: 100%; object-fit: cover;" referrerPolicy="no-referrer" />
-                <div style="position: absolute; top: 12px; right: 12px; background: rgba(255,255,255,0.95); padding: 4px 10px; border-radius: 8px; font-weight: 700; font-size: 11px; border: 1px solid #ebdccb; color: #1c1c19;">
-                    {bk['percentage']}%
-                </div>
-                <div style="position: absolute; bottom: 0; left: 0; right: 0; background: linear-gradient(0deg, rgba(0,0,0,0.85) 0%, rgba(0,0,0,0) 100%); padding: 12px; color: white;">
-                    <span style="font-size: 9px; text-transform: uppercase; letter-spacing: 1.5px; font-weight: 700; color: #f5841f;">{bk['category']}</span>
-                    <h5 class="serif-header" style="color: white !important; font-size: 15px; margin: 2px 0 0 0; text-overflow: ellipsis; white-space: nowrap; overflow: hidden;">{bk['title']}</h5>
-                </div>
-            </div>
-            <div style="padding: 16px; display: flex; flex-direction: column; gap: 10px;">
-                <div style="display: flex; justify-content: space-between; font-size: 11px; align-items: center;">
-                    <span style="color: #6f6257;">Narrator:</span>
-                    <span style="font-weight: 600; color: #944a00;">🌟 {bk['voice_name']}</span>
-                </div>
-                <div class="progress-bar-bg">
-                    <div class="progress-bar-fill" style="width: {bk['percentage']}%"></div>
-                </div>
-                <div style="text-align: center; padding: 6px 0; font-size: 12px; font-weight: 700; color: #944a00;">
-                    ▶️ Tap to Play
-                </div>
-            </div>
-        </div>
-        """
-    html += "</div>"
-    return html
+/* 목업 사운드 플레이어 하단 배너 바 */
+.bottom-player-bar {
+    background: #ffffff !important;
+    border-top: 1px solid rgba(221, 193, 176, 0.3) !important;
+    box-shadow: 0 -8px 24px rgba(74, 63, 53, 0.08) !important;
+    padding: 15px 30px !important;
+    position: fixed !important;
+    bottom: 0 !important;
+    left: 0 !important;
+    right: 0 !important;
+    z-index: 9999 !important;
+}
 
-def load_paragraphs(story_path: str) -> list:
-    try:
-        with open(story_path, encoding="utf-8") as f:
-            raw = f.read()
-        paras = [p.strip() for p in raw.split("\n\n") if p.strip()]
-        return paras
-    except Exception:
-        return []
+/* 리플 및 음계 파동 애니메이션 효과 */
+.speech-pulse-ring {
+    border: 3px solid #f5841f;
+    border-radius: 50%;
+    animation: ripple-effect 2s infinite ease-out;
+}
 
-def render_story_text(paragraphs: list, current_idx: int) -> str:
-    if not paragraphs:
-        return ""
-    html = """<div style="max-height: 420px; overflow-y: auto; padding: 4px 2px; margin-top: 12px;">"""
-    for i, para in enumerate(paragraphs):
-        if i == current_idx:
-            html += f"""<p style="font-family: 'Playfair Display', Georgia, serif; font-size: 13px; line-height: 1.8; color: #FAF7F2; background: rgba(245,132,31,0.18); border-left: 3px solid #f5841f; padding: 8px 12px; border-radius: 6px; margin: 6px 0;">{para}</p>"""
-        else:
-            html += f"""<p style="font-family: 'Playfair Display', Georgia, serif; font-size: 13px; line-height: 1.8; color: #94a3b8; padding: 4px 12px; margin: 4px 0;">{para}</p>"""
-    html += "</div>"
-    return html
+@keyframes ripple-effect {
+    0% { transform: scale(0.95); opacity: 1; }
+    100% { transform: scale(1.4); opacity: 0; }
+}
 
-def render_cloned_voices_html(voices_list):
-    html = """<div class="book-shelf-grid">"""
-    for v in voices_list:
-        status_color = "#16a34a" if v["status"] == "ready" else "#d97706"
-        status_bg = "#f0fdf4" if v["status"] == "ready" else "#fef3c7"
+.glow-btn {
+    background: #f5841f !important;
+    color: #ffffff !important;
+    font-weight: 600 !important;
+    border-radius: 30px !important;
+    border: none !important;
+}
+.glow-btn:hover {
+    background: #944a00 !important;
+}
+"""
 
-        html += f"""
-        <div class="shelf-card" style="align-items: center;">
-            <div style="width: 48px; height: 48px; border-radius: 50%; background: #ede8e3; border: 1px solid #ddc1b0; font-size: 24px; display: flex; align-items: center; justify-content: center; shrink-0: 0;">
-                {v['avatar_url']}
-            </div>
-            <div style="min-width: 0; flex: 1;">
-                <div style="display: flex; justify-content: space-between; align-items: center; gap: 6px;">
-                    <h5 class="serif-header" style="font-size: 14.5px; margin: 0; overflow: hidden; text-overflow: ellipsis; white-space: nowrap;">{v['name']}</h5>
-                    <span style="font-size: 9px; font-weight: 700; text-transform: uppercase; padding: 2px 6px; border-radius: 4px; color: {status_color}; background: {status_bg};">
-                        {v['status']}
-                    </span>
-                </div>
-                <p style="font-size: 11.5px; color: #6f6257; margin: 4px 0 0 0; clamp: 2; overflow: hidden; display: -webkit-box; -webkit-line-clamp: 2; -webkit-box-orient: vertical;">
-                    {v['description']}
-                </p>
-                <div style="border-top: 1px solid rgba(148,74,0,0.08); padding-top: 6px; margin-top: 6px; display: flex; justify-content: space-between; font-size: 10px; color: #6f6257;">
-                    <span>Gender: {v['gender']}</span>
-                    <span>Created: {v['created_date']}</span>
+with gr.Blocks(css=custom_theme_css, title="VoiceBook Frontend Prototype") as demo:
+    
+    # 상단 글로벌 앱 브랜딩 바
+    with gr.Row(elem_classes="brand-header-row"):
+        with gr.Column(scale=8):
+            gr.HTML("""
+                <div style="padding: 10px 0; margin-bottom: 5px;">
+                    <span class="brand-text" style="font-size: 2.3rem;">VoiceBook</span>
+                    <span style="font-size: 0.85rem; color: #564336; font-style: italic; margin-left: 15px;">Hear their voice, every story.</span>
                 </div>
-            </div>
-        </div>
-        """
-    html += "</div>"
-    return html
-
-
-# Gradio Application Core setup
-with gr.Blocks(css=css_code, title="VoiceBook Gradio Hub") as demo:
-
-    books_state = gr.State(mock_books)
-    voices_state = gr.State(mock_voices)
-    paragraphs_state = gr.State([])
-    tts_chunks_state = gr.State([])
-
-    gr.HTML("""
-    <div style="display: flex; align-items: center; justify-content: space-between; padding: 16px 0; border-bottom: 1px solid #ebdccb; margin-bottom: 24px; flex-wrap: wrap; gap: 16px;">
-        <div style="display: flex; align-items: center; gap: 12px;">
-            <div style="width: 42px; height: 42px; background-color: #944a00; border-radius: 12px; display: flex; align-items: center; justify-content: center; color: white; font-weight: bold; font-size: 20px;">
-                💿
-            </div>
-            <div>
-                <h1 class="serif-header" style="font-size: 22px; margin: 0; line-height: 1;">VoiceBook</h1>
-                <span style="font-size: 10px; color: #f5841f; font-weight: 700; text-transform: uppercase; letter-spacing: 1.5px;">AI Bedtime Story Narrator</span>
-            </div>
-        </div>
-        <div style="display: flex; align-items: center; gap: 6px; font-size: 11.5px; color: #6f6257; font-family: monospace;">
-            <span>Hugging Face Space Node:</span>
-            <span style="color: #16a34a; font-weight: 700;">● Active</span>
-        </div>
-    </div>
-    """)
+            """)
+        with gr.Column(scale=4, min_width=250):
+            with gr.Row():
+                user_info = gr.HTML("""
+                    <div style="display: flex; align-items: center; justify-content: flex-end; gap: 12px; padding-top: 15px;">
+                        <span style="font-size: 11px; background: #944a00; color: #fff; padding: 4px 10px; border-radius: 20px; font-weight: bold;">AI Calibration Active</span>
+                        <img src="https://images.unsplash.com/photo-1544005313-94ddf0286df2?auto=format&fit=crop&q=80&w=100" style="width: 38px; height: 38px; border-radius: 50%; border: 2px solid #f5841f; object-fit: cover;"/>
+                        <span style="font-size: 14px; font-weight: bold; color: #1c1c19;">Sarah</span>
+                    </div>
+                """)
 
+    # ==========================================
+    # 메인 네비게이션 탭 (gr.Tabs)
+    # ==========================================
     with gr.Tabs() as main_tabs:
-
-        # TAB 1: Explore Dashboard
-        with gr.TabItem("🏛️ Explore Space") as explore_tab:
-            dashboard_container = gr.HTML(value=generate_dashboard_html(mock_books))
-            gr.HTML("""<div style="margin-top: 24px; text-align: center;"><span style="font-size: 12px; color:#6f6257;">🎧 Head over to <b>My Library</b> and tap any book to start listening!</span></div>""")
-
-        # TAB 2: Library + Player (통합)
-        with gr.TabItem("📚 My Library") as library_tab:
+        
+        # ------------------------------------------
+        # 1. 홈 대시보드 뷰 (Page 1)
+        # ------------------------------------------
+        with gr.Tab("🏠 Home"):
+            gr.HTML("""
+                <div style="margin: 15px 0 25px 0;">
+                    <h2 class="editorial-title" style="font-size: 2rem; margin-bottom: 5px;">Good evening, Sarah</h2>
+                    <p style="color: #564336; font-size: 0.95rem; margin: 0;">가족의 목소리로 복제된 인공지능 내레이터 3명이 등록되어 있습니다.</p>
+                </div>
+            """)
+            
+            gr.HTML("""<h3 class="editorial-title" style="font-size: 1.4rem; border-bottom: 1px solid #ddc1b0; padding-bottom: 8px; margin-bottom: 20px;">🔥 Trending Stories</h3>""")
+            
+            # 피드북 그리드뷰
             with gr.Row():
-                # Left: book grid
-                with gr.Column(scale=3):
-                    with gr.Row():
-                        with gr.Column(scale=3):
-                            search_input = gr.Textbox(placeholder="Search by title, author, or voice...", label="Filter", show_label=False)
-                        with gr.Column(scale=1):
-                            category_filter = gr.Radio(["All", "In Progress", "Completed"], value="All", label="Progress", show_label=False)
-                        with gr.Column(scale=1):
-                            empty_state_sim = gr.Checkbox(label="Simulate Empty", value=False)
-
-                    shelf_grid = gr.HTML(value=generate_library_html(mock_books))
-
-                    # Hidden radio — book cards click this via JS onclick
-                    book_titles_list = [b["title"] for b in mock_books]
-                    book_selector = gr.Radio(
-                        choices=book_titles_list,
-                        value=None,
-                        label="",
-                        show_label=False,
-                        elem_classes="library-book-selector",
-                        visible=False,
-                    )
+                for idx, book in enumerate(DUMMY_BOOKS):
+                    with gr.Column(scale=3, elem_classes="book-card-container"):
+                        gr.HTML(f"""
+                            <div style="position: relative; border-radius: 12px; overflow: hidden; margin-bottom: 12px; height: 260px; background: #eee;">
+                                <img src="{book['cover']}" style="width: 100%; height: 100%; object-fit: cover;" />
+                                <span class="category-badge" style="position: absolute; top: 12px; right: 12px; background: rgba(0,0,0,0.6); color: #fff; border-radius: 4px; padding: 2px 8px; font-size: 10px;">{book['category']}</span>
+                            </div>
+                            <h4 class="editorial-title" style="font-size: 1.15rem; margin: 4px 0;">{book['title']}</h4>
+                            <p style="color: #564336; font-size: 0.85rem; margin: 0 0 10px 0;">by {book['author']}</p>
+                            <div style="display: flex; justify-content: space-between; align-items: center; border-top: 1px solid rgba(221,193,176,0.2); padding-top: 10px;">
+                                <span style="font-size: 11px; background: #ffdcc6; color: #944a00; font-weight: bold; padding: 3px 8px; border-radius: 6px;">🎙️ {book['narrator']}</span>
+                            </div>
+                        """)
+                        # 책 제목이나 상세를 클릭해서 디테일 창으로 전환하는 듯한 시각적 트리깅을 위해 가짜 버튼 연동
+                        book_select_btn = gr.Button(f"🎧 '{book['title']}' 재생 대기선에 추가", variant="secondary", size="sm")
+                        
+                        # 가짜 인터랙션 오디오 컨트롤 바 로직 연동
+                        def make_book_selector(title=book['title'], auth=book['author'], cover=book['cover'], narrator=book['narrator']):
+                            def select_handler():
+                                time.sleep(0.5)
+                                gr.Info(f"'{title}'을 오디오 재생기에 로드했습니다.")
+                                return (
+                                    f"📡 Now Ready: {title}",
+                                    f"🎙️ 내레이터: {narrator}",
+                                    gr.update(visible=True)
+                                )
+                            return select_handler
+                        
+                        # 하단 플레이어와 직접 바인딩
+
+            gr.HTML("""<h3 class="editorial-title" style="font-size: 1.4rem; border-bottom: 1px solid #ddc1b0; padding-bottom: 8px; margin-top: 40px; margin-bottom: 20px;">🔊 Your Cloned Family Library</h3>""")
+            
+            with gr.Row():
+                for i in range(2):
+                    extra_title = "Peter Pan" if i == 0 else "The Little Prince"
+                    extra_author = "J.M. Barrie" if i == 0 else "Antoine de Saint-Exupéry"
+                    extra_cover = "https://images.unsplash.com/photo-1543002588-bfa74002ed7e?auto=format&fit=crop&q=80&w=300" if i == 0 else "https://images.unsplash.com/photo-1476275466078-4007374efbbe?auto=format&fit=crop&q=80&w=300"
+                    
+                    with gr.Column(scale=6, elem_classes="book-card-container"):
+                        gr.HTML(f"""
+                            <div style="display: flex; gap: 20px;">
+                                <img src="{extra_cover}" style="width: 100px; height: 135px; object-fit: cover; border-radius: 10px; box-shadow: 0 4px 10px rgba(0,0,0,0.1);" />
+                                <div style="display: flex; flex-direction: column; justify-content: space-between;">
+                                    <div>
+                                        <span style="font-size: 10px; background: #944a00; color: #fff; padding: 2px 6px; border-radius: 4px; font-weight: bold;">MOM'S CLONE</span>
+                                        <h4 class="editorial-title" style="font-size: 1.2rem; margin: 5px 0 2px 0;">{extra_title}</h4>
+                                        <span style="color: #564336; font-size: 0.85rem;">by {extra_author}</span>
+                                    </div>
+                                    <div style="font-size: 0.8rem; color: #944a00; font-weight: bold;">
+                                        ⏱️ 8시간 12분 전체본 완독 가능
+                                    </div>
+                                </div>
+                            </div>
+                        """)
+                        play_cloned_btn = gr.Button(f"엄마 목소리로 '{extra_title}' 재생 시작", elem_classes="glow-btn", size="sm")
 
-                # Right: player panel
-                with gr.Column(scale=2, elem_classes="dark-card-container"):
+        # ------------------------------------------
+        # 2. 내 라이브러리 목록뷰 (Page 2 / 상세 및 필터)
+        # ------------------------------------------
+        with gr.Tab("📚 My Library"):
+            with gr.Row():
+                with gr.Column(scale=9):
                     gr.HTML("""
-                        <div style="display: flex; justify-content: space-between; align-items: center; border-bottom: 1px dashed rgba(255,255,255,0.15); padding-bottom: 12px; margin-bottom: 16px;">
-                            <span style="font-size: 10px; text-transform: uppercase; letter-spacing: 2px; color: #f5841f; font-weight: 700;">Now Playing</span>
-                            <span style="background: rgba(22, 163, 74, 0.2); padding: 2px 6px; border-radius: 6px; font-size: 9px; font-family: monospace; color: #4ade80;">SYNCHRONIZED PITCH</span>
-                        </div>
-                    """)
-
-                    player_title_info = gr.HTML("""
-                        <div style="text-align: center; margin-bottom: 24px; margin-top: 16px; padding: 32px 0;">
-                            <span style="font-size: 48px;">📖</span>
-                            <h3 style="font-family: 'Playfair Display', Georgia, serif; font-size: 18px; margin: 12px 0 4px; color:#FAF7F2;">Select a story</h3>
-                            <p style="font-size: 12px; color: #94a3b8; font-style: italic;">Tap any book on the left to begin</p>
-                        </div>
-                    """)
-
-                    player_audio_control = gr.Audio(
-                        visible=False, interactive=False,
-                        label="Audio Stream",
-                        type="numpy",
-                        streaming=True,
-                        autoplay=True,
-                    )
-
-                    player_status_bar = gr.HTML("""
-                        <div style="margin-top: 12px; display: flex; align-items: center; gap: 10px; justify-content: center;">
-                            <span style="width: 8px; height: 8px; border-radius: 50%; background: #94a3b8; display: inline-block;"></span>
-                            <span style="font-size: 11px; color: #94a3b8; font-family: monospace;">SELECT A STORY</span>
-                        </div>
-                    """)
-
-                    with gr.Row():
-                        play_btn   = gr.Button("▶️ Play",          variant="primary",   scale=1, visible=False)
-                        pause_btn  = gr.Button("⏸ Pause",          variant="secondary",  scale=1, visible=False)
-                        resume_btn = gr.Button("↩️ Resume Story",   variant="secondary",  scale=2, visible=False)
-
-                    with gr.Row():
-                        ask_btn = gr.Button("❓ Ask a Question", variant="primary", scale=2, visible=False)
-
-                    chunk_status = gr.HTML("""
-                        <div style="margin-top: 8px; font-size: 10px; color: #64748b; font-family: monospace; text-align: center;">
-                            Chunk 0 / 0
+                        <div style="margin: 15px 0;">
+                            <h2 class="editorial-title" style="font-size: 2rem; margin-bottom: 5px;">My Personal Library</h2>
+                            <p style="color: #564336; font-size: 0.95rem; margin: 0;">Sarah가 담아두거나 음성을 연결한 오디오북 목록입니다.</p>
                         </div>
                     """)
-
-                    story_finished_panel = gr.HTML("""
-                        <div style="margin-top: 12px; padding: 16px; background: rgba(245,132,31,0.1); border: 1px solid rgba(245,132,31,0.3); border-radius: 14px; text-align: center;">
-                            <span style="font-size: 28px;">🎉</span>
-                            <h4 style="font-family: 'Playfair Display', Georgia, serif; color: #ffd3a6; margin: 8px 0 4px;">Story Complete!</h4>
-                            <p style="font-size: 12px; color: #94a3b8; margin-bottom: 12px;">Tap another book to start a new story.</p>
-                        </div>
-                    """, visible=False)
-
-                    # Story text display + slider
-                    story_text_display = gr.HTML(visible=False)
-                    timeline_slider = gr.Slider(minimum=0, maximum=100, step=1, value=0, label="📍 Story position (paragraph)", visible=False)
-
-                    # Q&A Panel
-                    qa_panel = gr.HTML("""
-                        <div style="margin-top: 20px; border-top: 1px solid rgba(255,255,255,0.1); padding-top: 16px;">
-                            <h4 style="font-family: 'Playfair Display', Georgia, serif; font-size: 14px; margin-bottom: 12px; color: #FAF7F2;">❓ Ask About the Story</h4>
-                        </div>
-                    """, visible=False)
-
-                    with gr.Group(visible=False) as qa_input_group:
-                        question_text = gr.Textbox(
-                            placeholder="Type your question about the story here...",
-                            label="Your Question", lines=2, show_label=False
-                        )
-                        question_audio = gr.Audio(
-                            sources=["microphone"], type="filepath",
-                            label="Or speak your question", show_label=True
-                        )
-                        submit_question_btn = gr.Button("🔍 Get Answer in Cloned Voice", variant="primary")
-
-                    answer_display = gr.HTML(visible=False)
-                    answer_audio = gr.Audio(label="Answer in Narrator's Voice", interactive=False, visible=False)
-
-        # TAB 3: Clone Voice Studio
-        with gr.TabItem("🎙️ Clone Voice Studio") as clone_tab:
+                with gr.Column(scale=3):
+                    # 필터 및 정렬
+                    sort_dropdown = gr.Dropdown(choices=["최근 들은 순", "제목 가나다순", "진행률 높은 순"], value="최근 들은 순", label="소팅 정렬")
+            
             with gr.Row():
-                with gr.Column(scale=1, elem_classes="card-container"):
-                    gr.HTML("""
-                        <h3 class="serif-header" style="font-size: 18px; margin-bottom: 4px; display: flex; align-items: center; gap: 8px;">🧙 Voice Details Form</h3>
-                        <p style="font-size: 12px; color: #6f6257; margin-bottom: 20px;">Provide a comforting nickname and details below to prepare vocal weights matching.</p>
-                    """)
-
-                    new_voice_name = gr.Textbox(placeholder="Enter a descriptive nickname (e.g., Grandma Judy, Dad)...", label="Voice Nickname")
-                    new_voice_gender = gr.Radio(["Female", "Male"], value="Female", label="Voice Gender Avatar")
-
-                    gr.HTML("""
-                        <div style="margin: 16px 0; padding: 12px; background: white; border-radius: 12px; border: 1px solid #ebdccb; font-size: 12px;">
-                            <strong style="color: #6f6257; text-transform: uppercase; font-size: 10px; display: block; margin-bottom: 4px;">Story Script to read aloud:</strong>
-                            <p style="font-family: Georgia, serif; font-style: italic; color: #1c1c19; margin: 0; line-height: 1.4;">
-                                "Deep within the ancient forest, the giant oak tree stood. Its roots whispered stories of forgotten eras. 'Close your eyes,' the wind hummed softly, 'for our beautiful journey begins tonight.'"
+                # 필터 칩 시뮬레이터 (전체 / 진행 중 / 완독)
+                filter_all = gr.Button("🔵 전체보기 (6개)", variant="primary", size="sm")
+                filter_progress = gr.Button("🟠 진행 중 (4개)", variant="secondary", size="sm")
+                filter_completed = gr.Button("🟢 완독 완료 (2개)", variant="secondary", size="sm")
+
+            # 상세 2단 카드 그리드
+            with gr.Row(style="margin-top: 20px;"):
+                for b in DUMMY_BOOKS:
+                    with gr.Column(scale=6, elem_classes="book-card-container"):
+                        gr.HTML(f"""
+                            <div style="display: flex; gap: 20px;">
+                                <div style="position: relative; width: 110px; height: 150px; background: #eee; border-radius: 8px; overflow: hidden; flex-shrink: 0;">
+                                    <img src="{b['cover']}" style="width: 100%; height: 100%; object-fit: cover;" />
+                                </div>
+                                <div style="display: flex; flex-direction: column; justify-content: space-between; width: 100%;">
+                                    <div>
+                                        <h4 class="editorial-title" style="font-size: 1.25rem; margin: 0 0 3px 0;">{b['title']}</h4>
+                                        <p style="color: #564336; font-size: 0.85rem; margin: 0 0 6px 0;">by {b['author']}</p>
+                                        <div style="font-size: 11px; color: #944a00; font-weight: bold; margin-bottom: 10px;">
+                                            🎙️ {b['narrator']} 연결 완료
+                                        </div>
+                                    </div>
+                                    
+                                    <!-- 진행 상황 바 디자인 모사 -->
+                                    <div style="margin-top: auto;">
+                                        <div style="display: flex; justify-content: space-between; font-size: 11px; color: #564336; font-weight: bold; margin-bottom: 4px;">
+                                            <span>{b['progress']}% 듣는 중</span>
+                                            <span>{b['time_left']}</span>
+                                        </div>
+                                        <div style="background: #f1dfd1; border-radius: 10px; height: 6px; width: 100%; overflow: hidden;">
+                                            <div style="background: #f5841f; height: 100%; width: {b['progress']}%;"></div>
+                                        </div>
+                                    </div>
+                                </div>
+                            </div>
+                        """)
+                        with gr.Row():
+                            peek_detail_btn = gr.Button("📖 상세 시놉시스 보기", size="sm")
+                            play_direct_btn = gr.Button("▶️ 바로 재생", size="sm", variant="primary")
+                            
+                            def render_synopsis(b_title=b['title'], b_desc=b['desc'], b_dur=b['duration']):
+                                def trigger_alert():
+                                    return gr.update(
+                                        value=f"### 📖 {b_title} 시놉시스\n\n{b_desc}\n\n* **전체 재생 시간**: {b_dur} | **복제 내레이션 지원**",
+                                        visible=True
+                                    )
+                                return trigger_alert
+                            
+            # 책 상세 팝업 패널 시뮬레이션
+            book_detail_panel = gr.Markdown(visible=False, elem_id="detail-info-markdown", style="padding: 20px; background: #fff; border: 1px solid #ddc1b0; border-radius: 15px; margin-top: 15px;")
+
+        # ------------------------------------------
+        # 3. AI 음성 생성 및 오디오북 클론 프로세스 (Page 6)
+        # ------------------------------------------
+        with gr.Tab("🎙️ AI Voice Cloning"):
+            gr.HTML("""
+                <div style="margin: 15px 0 30px 0; text-align: center;">
+                    <h2 class="editorial-title" style="font-size: 2.2rem; margin-bottom: 5px;">엄마/아빠 목소리 복제 마법사</h2>
+                    <p style="color: #564336; font-size: 1rem; max-width: 600px; margin: 0 auto;">가족의 짧은 오디오 음성 녹음본(10초~30초)을 제공하면, 인공지능이 발성 기관과 감정 레이어를 빌드하여 어떠한 길고 어려운 도서도 이질감 없이 온화하게 구현해 냅니다.</p>
+                </div>
+            """)
+            
+            with gr.Row():
+                with gr.Column(scale=5, elem_classes="book-card-container"):
+                    gr.HTML("<h3 class='editorial-title' style='font-size: 1.25rem; margin-bottom: 15px;'>1단계: 목소리 트레이닝 에셋 업로드</h3>")
+                    
+                    # 파일 업로드 (드래그앤드롭 지원)
+                    voice_file = gr.File(label="가족의 음성 파일 (MP3, WAV, M4A) 업로드", file_types=["audio"])
+                    
+                    with gr.Accordion("직접 가볍게 녹음해보기", open=False):
+                        mic_recorder = gr.Audio(sources=["microphone"], type="filepath", label="30초간 가이드를 따라 읽어보세요")
+                        gr.HTML("""
+                            <p style="font-size: 12px; color: #564336; font-style: italic; line-height: 1.5; background: #fff; padding: 10px; border-radius: 8px;">
+                                <b>낭독 가이드 문장:</b> "옛날 옛적 아주 먼 우주 너머, 별들이 부드러운 이불벨벳처럼 내려앉은 고요한 밤하늘 아래, 우주선 스타라이트의 모험을 너무나 사랑했던 작은 꿈나무 아이가 살고 있었습니다..."
                             </p>
+                        """)
+                    
+                    cloning_name = gr.Textbox(placeholder="예: 엄마 낭독용, 할머니 잠투정 전용", label="클로닝할 목소리의 저장 이름")
+                    clone_trigger_btn = gr.Button("✨ AI 클로닝 및 신경망 임베딩 연산 시작", elem_classes="glow-btn")
+
+                with gr.Column(scale=7, elem_classes="book-card-container"):
+                    gr.HTML("<h3 class='editorial-title' style='font-size: 1.25rem; margin-bottom: 15px;'>2단계: 현재 클로닝 엔진 백엔드 모니터</h3>")
+                    
+                    progress_html_gauge = gr.HTML("""
+                        <div style="text-align: center; padding: 25px 0;">
+                            <!-- 순수 CSS 원형 로더를 모사한 대형 비주얼 서클 -->
+                            <div style="position: relative; width: 140px; height: 140px; margin: 0 auto 20px auto; border-radius: 50%; background: conic-gradient(#f5841f 115deg, #f1dfd1 0); display: flex; align-items: center; justify-content: center;">
+                                <div style="position: absolute; width: 110px; height: 110px; border-radius: 50%; background: #ffffff; display: flex; flex-direction: column; align-items: center; justify-content: center;">
+                                    <span style="font-size: 1.8rem; font-weight: bold; color: #944a00;">32%</span>
+                                    <span style="font-size: 10px; color: #564336; font-weight: bold; text-transform: uppercase;">Processing</span>
+                                </div>
+                            </div>
+                            <h4 class="editorial-title" style="font-size: 1.25rem; margin-bottom: 8px;">Preparing core acoustic layer...</h4>
+                            <p style="font-size: 12px; color: #564336; max-width: 320px; margin: 0 auto; line-height: 1.5;">성대의 발성 스펙트럼 마커 분석 및 음소 임베딩 매핑 작업을 진행중입니다. 잠시만 대기해주세요.</p>
                         </div>
                     """)
+                    
+                    progress_bar_sim = gr.Slider(minimum=0, maximum=100, value=32, interactive=False, label="가상 서버 프로세싱 미터기")
+                    
+                    with gr.Row():
+                        chk_progress_btn = gr.Button("🔁 상태 갱신", variant="secondary")
+                        notify_btn = gr.Button("🔔 클로닝 완료시 Push 알림 신청", variant="secondary")
+                        
+                    # 경고창 연동 시뮬레이션
+                    def mock_clone_process(file, name):
+                        if not file or not name:
+                            gr.Warning("경고: 더미 음성 에셋 파일과 생성할 이명을 정확하게 기입해주십시오!")
+                            return 32, gr.update()
+                        
+                        # 2초간 딜레이 후 98%로 완성을 테스트하는 시각적 피드백 구현
+                        time.sleep(2.0)
+                        gr.Info("성공적으로 오디오 파일 파싱 및 클로닝 레이어 추출이 마무리 단계에 접어들었습니다!")
+                        
+                        success_html = """
+                            <div style="text-align: center; padding: 25px 0;">
+                                <div style="position: relative; width: 140px; height: 140px; margin: 0 auto 20px auto; border-radius: 50%; background: conic-gradient(#4caf50 360deg, #f1dfd1 0); display: flex; align-items: center; justify-content: center;">
+                                    <div style="position: absolute; width: 110px; height: 110px; border-radius: 50%; background: #ffffff; display: flex; flex-direction: column; align-items: center; justify-content: center;">
+                                        <span style="font-size: 1.8rem; font-weight: bold; color: #4caf50;">100%</span>
+                                        <span style="font-size: 10px; color: #564336; font-weight: bold; text-transform: uppercase;">READY</span>
+                                    </div>
+                                </div>
+                                <h4 class="editorial-title" style="font-size: 1.25rem; text-align: center; color: #4caf50; margin-bottom: 8px;">Voice Profile Calibrated Successfully 🎉</h4>
+                                <strong class="editorial-title" style="font-size: 1rem;">"{name} (AI)" 프로필이 이제 내레이터 선택 풀에 완벽하게 추가되었습니다.</strong>
+                            </div>
+                        """
+                        return 100, gr.update(value=success_html)
+                    
+                    clone_trigger_btn.click(
+                        fn=mock_clone_process, 
+                        inputs=[voice_file, cloning_name], 
+                        outputs=[progress_bar_sim, progress_html_gauge]
+                    )
 
-                    mic_recorder = gr.Audio(sources=["microphone"], type="filepath", label="Record speaking story prompt (Min 10 seconds sample)")
-                    extract_btn = gr.Button("🪄 Analyze & Synthesize Customized Vocal Profile", variant="primary")
-
-                with gr.Column(scale=1, elem_classes="card-container"):
-                    gr.HTML("""
-                        <h3 class="serif-header" style="font-size: 18px; margin-bottom: 4px;">Status Pipeline Visualizer</h3>
-                        <p style="font-size: 12px; color: #6f6257; margin-bottom: 16px;">Track extraction, de-noising, and pitch tuning.</p>
-                    """)
-
-                    cloning_progress_msg = gr.HTML("""
-                        <div style="text-align: center; padding: 32px 0;">
-                            <span style="font-size: 42px;">🎙️</span>
-                            <p style="margin-top: 12px; font-size: 14px; color: #6f6257;">Fill parameters on the left and read the story script aloud to begin extraction.</p>
-                        </div>
-                    """)
-
-                    loading_spinner = gr.HTML(visible=False)
-                    voice_cloning_success_panel = gr.HTML(visible=False)
-                    voice_sample_preview_widget = gr.Audio(value="sample_sounds/cloned_preview.wav", visible=False, label="Pre-listening synthesized vocal pitch weights match preview", interactive=False)
-                    add_to_library_btn = gr.Button("✨ Synced successfully! Bind Companion Voice to Inventory", visible=False)
-
+        # ------------------------------------------
+        # 4. 에러 및 예외 케이스 샌드박스 테스터 (Pages 7, 8, 9, 3)
+        # ------------------------------------------
+        with gr.Tab("🧪 Fallback Screens Sandbox"):
             gr.HTML("""
-                <div style="margin-top: 32px; border-top: 1px solid #ebdccb; padding-top: 24px;">
-                    <h4 class="serif-header" style="font-size: 18px; margin-bottom: 16px;">Currently Available Voices</h4>
+                <div style="margin: 15px 0 20px 0;">
+                    <h2 class="editorial-title" style="font-size: 1.7rem; margin-bottom: 5px;">UX Fallback State Tester</h2>
+                    <p style="color: #564336; font-size: 0.9rem; margin: 0;">개발 뼈대 설계 단계에서 오프라인, 검색 에러, 비어있는 화면이 어떤 시각 디자인으로 가공되는지 샌드박스로 미리 점검해보세요.</p>
                 </div>
             """)
-            cloned_voices_list_grid = gr.HTML(value=render_cloned_voices_html(mock_voices))
-
-        # TAB 4: Profile & Sandbox Settings
-        with gr.TabItem("⚙️ Profile & Sandbox Settings") as profile_tab:
+            
             with gr.Row():
-                with gr.Column(scale=1, elem_classes="card-container"):
+                btn_tr_404 = gr.Button("🔍 404: 도서 불발 상태 (Page 7)", variant="secondary")
+                btn_tr_empty = gr.Button("📭 Library Empty: 텅 빈 서재 (Page 8)", variant="secondary")
+                btn_tr_offline = gr.Button("🔌 Offline: 네트워크 단절 (Page 9)", variant="secondary")
+                btn_tr_login = gr.Button("🗝️ Sign In: 미인증 진입 (Page 3)", variant="secondary")
+            
+            # 단일 하프 스크린 동적 가시성 존
+            sandbox_viewport = gr.Column(visible=True)
+            
+            with sandbox_viewport:
+                # 404 View
+                view_404 = gr.Column(visible=False, elem_classes="book-card-container", style="max-width: 550px; margin: 0 auto; text-align: center; padding: 40px;")
+                with view_404:
                     gr.HTML("""
-                        <div style="text-align: center; margin-bottom: 24px;">
-                            <div style="width: 72px; height: 72px; border-radius: 50%; background: #944a00; color: white; font-size: 36px; display: flex; align-items: center; justify-content: center; margin: 0 auto 12px auto;">
-                                👩‍💻
-                            </div>
-                            <h3 class="serif-header" style="font-size: 18px; margin: 0;">Sarah Jenkins</h3>
-                            <p style="font-size: 11.5px; color: #6f6257; margin-top: 2px;">Premium Member since Summer 2026</p>
+                        <div style="text-align: center;">
+                            <img src="https://images.unsplash.com/photo-1579783900882-c0d3dad7b119?auto=format&fit=crop&q=80&w=300" style="width: 140px; height: 140px; border-radius: 20px; object-fit: cover; margin: 0 auto 20px auto; opacity: 0.8;" />
+                            <span style="background: #ba1a1a; color: #fff; padding: 4px 12px; font-weight: bold; border-radius: 20px; font-size: 12px;">Oops! ERROR_404</span>
+                            <h3 class="editorial-title" style="font-size: 1.8rem; margin: 15px 0 10px 0;">This book couldn't be found</h3>
+                            <p style="color: #564336; font-size: 14px; max-width: 380px; margin: 0 auto 24px auto;">해당 장서는 제거되었거나 올바르지 않은 공유 경로입니다. 걱정 마세요, 홈 서재에서 안전한 책장을 다시 추천 받아보실 수 있습니다.</p>
                         </div>
                     """)
+                    back_lib_from_404 = gr.Button("도서관 홈으로 안전하게 대피", variant="primary", size="sm")
 
+                # Empty State View
+                view_empty = gr.Column(visible=False, elem_classes="book-card-container", style="max-width: 550px; margin: 0 auto; text-align: center; padding: 40px;")
+                with view_empty:
                     gr.HTML("""
-                        <div style="display: grid; grid-template-columns: 1fr 1fr 1fr; gap: 8px; text-align: center;">
-                            <div style="background: white; border: 1px solid #ebdccb; border-radius: 12px; padding: 10px;">
-                                <span style="font-size: 18px; display: block;">📚</span>
-                                <strong style="font-size: 15px; display: block; color: #1c1c19;">5</strong>
-                                <span style="font-size: 9px; text-transform: uppercase; color: #6f6257;">Bookshelf</span>
-                            </div>
-                            <div style="background: white; border: 1px solid #ebdccb; border-radius: 12px; padding: 10px;">
-                                <span style="font-size: 18px; display: block;">⏱️</span>
-                                <strong style="font-size: 15px; display: block; color: #1c1c19;">14.6h</strong>
-                                <span style="font-size: 9px; text-transform: uppercase; color: #6f6257;">Listen Time</span>
-                            </div>
-                            <div style="background: white; border: 1px solid #ebdccb; border-radius: 12px; padding: 10px;">
-                                <span style="font-size: 18px; display: block;">🎙️</span>
-                                <strong style="font-size: 15px; display: block; color: #1c1c19;">3</strong>
-                                <span style="font-size: 9px; text-transform: uppercase; color: #6f6257;">Cloned Cast</span>
+                        <div style="text-align: center;">
+                            <div style="width: 100px; height: 100px; border-radius: 50%; background: #f6f3ee; display: flex; align-items: center; justify-content: center; margin: 0 auto 20px auto;">
+                                <span style="font-size: 40px;">📭</span>
                             </div>
+                            <h3 class="editorial-title" style="font-size: 1.8rem; margin: 15px 0 10px 0;">Your library is empty</h3>
+                            <p style="color: #564336; font-size: 14px; max-width: 380px; margin: 0 auto 24px auto;">단 하나의 오디오북 장서 목록이나 고정된 부모/가족의 학습 음성이 생성되어 있지 않습니다. 지금 녹음을 완료해 이 서재를 가득 메워보세요.</p>
                         </div>
                     """)
+                    direct_voice_reg = gr.Button("🎙️ 30초 음성 기록실로 바로가기", variant="primary", size="sm")
 
-                    gr.HTML("""<div style="margin-top: 24px;"><h4 class="serif-header" style="font-size: 14px; margin-bottom: 8px;">Acoustic Signal Processing Config</h4></div>""")
-                    gr.Checkbox(label="Enable Client Denoising Filter", value=True)
-                    gr.Checkbox(label="Enable Brownian Dynamic Sleep Wave", value=False)
-                    gr.Checkbox(label="Automatic Chapter Transitions", value=True)
-
-                with gr.Column(scale=1, elem_classes="card-container"):
-                    gr.HTML("""
-                        <h3 class="serif-header" style="font-size: 18px; margin-bottom: 4px;">Boundary Connection Error Diagnostics</h3>
-                        <p style="font-size: 12px; color: #6f6257; margin-bottom: 16px;">Test robust offline error conditions gracefully.</p>
-                    """)
-
-                    offline_toggle = gr.Checkbox(label="Simulate Sandbox Connection Outage", value=False)
-
+                # Offline View
+                view_offline = gr.Column(visible=False, elem_classes="book-card-container", style="max-width: 550px; margin: 0 auto; text-align: center; padding: 40px;")
+                with view_offline:
                     gr.HTML("""
-                        <div style="margin-top: 16px; padding: 12px; background: white; border-radius: 12px; border: 1px solid #ebdccb;">
-                            <span style="font-size:10px; font-weight:700; text-transform:uppercase; color:#6f6257; display:block; margin-bottom:6px;">Sandbox local metric stores:</span>
-                            <div style="font-size: 11.5px; color: #1c1c19;">
-                                💾 Voice Weights Space Cache: 24.8 MB / 512 MB<br>
-                                📦 Cached offline items: 182 MB (12%)
+                        <div style="text-align: center;">
+                            <div style="width: 100px; height: 100px; border-radius: 50%; background: #ffebee; display: flex; align-items: center; justify-content: center; margin: 0 auto 20px auto;">
+                                <span style="font-size: 40px; color: #ba1a1a;">🔌</span>
                             </div>
+                            <h3 class="editorial-title" style="font-size: 1.8rem; margin: 15px 0 10px 0;">Can't reach the story</h3>
+                            <p style="color: #564336; font-size: 14px; max-width: 380px; margin: 0 auto 10px auto;">네트워크 단절 상태입니다. 무선 물리적 라우터 설정 상태 및 게이트웨이 정합성을 검증해주세요.</p>
+                            <span style="font-size: 10px; color: #ba1a1a; font-weight: bold; font-family: monospace;">ERROR_CODE: NO_CONN_004</span>
                         </div>
                     """)
+                    gr.HTML("<div style='height: 15px;'></div>")
+                    with gr.Row():
+                        offline_retry_btn = gr.Button("🔁 재접속 전송 요청", variant="primary", size="sm")
+                        offline_cache_btn = gr.Button("💾 오프라인 로컬 캐시 이용", variant="secondary", size="sm")
 
-                    error_sim_view = gr.HTML("""
-                        <div style="margin-top: 16px; padding: 16px; background: #fef2f2; border: 1px solid #fecaca; border-radius: 12px; display: none;" id="error-sim-panel">
-                            <span style="font-size: 20px; display: block; margin-bottom: 4px;">⚠️ Connection Interruption Layout</span>
-                            <strong style="color: #991b1b; font-size:14px; display:block;">Can't reach the story right now</strong>
-                            <p style="color: #7f1d1d; font-size: 11.5px; margin-top:4px; line-height:1.4;">The signal to Whispering Woods took a brief tumble. Verify your client network link or refresh the bookshelf items.</p>
+                # Login View
+                view_login = gr.Column(visible=False, elem_classes="book-card-container", style="max-width: 450px; margin: 0 auto; text-align: center; padding: 35px;")
+                with view_login:
+                    gr.HTML("""
+                        <div style="text-align: center; margin-bottom: 25px;">
+                            <h3 class="editorial-title" style="font-size: 1.9rem; margin-bottom: 4px;">VoiceBook</h3>
+                            <p style="color: #564336; font-size: 13px; font-style: italic;">Hear their voice, every story</p>
                         </div>
-                    """, elem_id="error-sim-block")
-
-    system_error_modal = gr.HTML("""
-    <div style="display: none; background-color: #FAF7F2; padding: 48px 16px; text-align: center; border-radius: 20px; border: 2px solid #fecaca; max-width: 460px; margin: 40px auto;" id="global-sandbox-error">
-        <div style="width: 72px; height: 72px; border-radius: 16px; background: #fff5f5; border: 1px solid #fecaca; display: flex; align-items: center; justify-content: center; margin: 0 auto 20px auto; font-size: 36px;">
-            ⚠️
-        </div>
-        <span style="font-size: 10px; font-weight: 700; color: #dc2626; text-transform: uppercase; letter-spacing: 2px;">Offline Connection Interruption</span>
-        <h2 class="serif-header" style="font-size: 24px; margin: 8px 0;">Can't reach the story right now</h2>
-        <p style="font-size: 13.5px; color: #6f6257; line-height: 1.5; margin-bottom: 24px;">The signal to Whispering Woods took a brief tumble. Verify your client network link or try refreshing.</p>
-        <div style="background: #ede8e3; padding: 10px; border-radius: 10px; font-size: 11px; color:#6f6257; font-family: monospace;">
-            Boundary Sandbox Mode Enabled. Uncheck settings switch to resume.
-        </div>
-    </div>
-    """, visible=False)
-
-    # REACTIVE LOGIC
-
-    # 1. Search / filter shelf
-    def filter_books_shelf(query, category, empty_mode_active, current_books):
-        if empty_mode_active:
-            return generate_library_html(current_books, empty_mode=True)
-        return generate_library_html(current_books, query=query, category_filt=category)
-
-    search_input.change(filter_books_shelf, inputs=[search_input, category_filter, empty_state_sim, books_state], outputs=shelf_grid)
-    category_filter.change(filter_books_shelf, inputs=[search_input, category_filter, empty_state_sim, books_state], outputs=shelf_grid)
-    empty_state_sim.change(filter_books_shelf, inputs=[search_input, category_filter, empty_state_sim, books_state], outputs=shelf_grid)
-
-    # 2. Book card click → load into player
-    def handle_book_select(title_chosen, current_inventory):
-        if not title_chosen:
-            return [gr.update()] * 12
-        selected = next((b for b in current_inventory if b["title"] == title_chosen), current_inventory[0])
-
-        player_html = f"""
-        <div style="text-align: center; margin-bottom: 16px; margin-top: 8px;">
-            <img src="{selected['cover_url']}" style="width: 110px; height: 155px; object-fit: cover; border-radius: 12px; box-shadow: 0 4px 16px rgba(0,0,0,0.4); margin-bottom: 12px;" />
-            <h3 style="font-family: 'Playfair Display', Georgia, serif; font-size: 20px; margin:0; color:#FAF7F2;">{selected['title']}</h3>
-            <p style="font-size: 12px; color: #94a3b8; font-style: italic; margin-top:2px;">by {selected['author']}</p>
-            <span style="display: inline-block; background: rgba(245, 132, 31, 0.15); color: #ffd3a6; font-size: 10.5px; font-weight: 700; padding: 3px 8px; border-radius: 999px; margin-top: 6px;">Active Narrator: {selected['voice_name']}</span>
-        </div>
-        """
-        paras = load_paragraphs(selected["story_path"])
-        total = max(len(paras) - 1, 0)
-        tts_chunks = split_into_chunks("\n\n".join(paras))
-        chunk_html = f"""<div style="margin-top: 8px; font-size: 10px; color: #64748b; font-family: monospace; text-align: center;">{len(tts_chunks)} chunks ready — tap Play</div>"""
-        status_html = """
-            <div style="margin-top: 12px; display: flex; align-items: center; gap: 10px; justify-content: center;">
-                <span style="width: 8px; height: 8px; border-radius: 50%; background: #94a3b8; display: inline-block;"></span>
-                <span style="font-size: 11px; color: #94a3b8; font-family: monospace;">READY</span>
-            </div>
-        """
-        story_html = render_story_text(paras, 0)
-        return (
-            player_html,
-            gr.Audio(visible=True),
-            status_html,
-            chunk_html,
-            gr.Button(visible=True),   # play_btn
-            gr.Button(visible=False),  # pause_btn
-            gr.Button(visible=False),  # ask_btn
-            gr.HTML(visible=False),    # story_finished_panel
-            paras,                     # paragraphs_state
-            tts_chunks,                # tts_chunks_state
-            gr.HTML(value=story_html, visible=True),   # story_text_display
-            gr.Slider(minimum=0, maximum=total, step=1, value=0, visible=True),  # timeline_slider
-        )
-
-    book_selector.change(
-        handle_book_select,
-        inputs=[book_selector, books_state],
-        outputs=[player_title_info, player_audio_control, player_status_bar, chunk_status,
-                 play_btn, pause_btn, ask_btn, story_finished_panel,
-                 paragraphs_state, tts_chunks_state, story_text_display, timeline_slider]
-    )
-
-    # 3. Extract vocal weights trigger
-    def animate_cloning_pipeline(v_name, v_gender, recorder_data, progress=gr.Progress()):
-        if not v_name.strip():
-            return (
-                """<div style="padding: 12px; background: #fef2f2; border: 1px solid #fecaca; color: #991b1b; border-radius: 12px; font-size: 12px; font-weight: 600;">
-                    ⚠️ Please provide a comforting nickname for your cloning candidate.
-                   </div>""",
-                gr.HTML(visible=False),
-                gr.HTML(visible=False),
-                gr.Audio(visible=False),
-                gr.Button(visible=False)
-            )
-        if recorder_data is None:
-            return (
-                """<div style="padding: 12px; background: #fef2f2; border: 1px solid #fecaca; color: #991b1b; border-radius: 12px; font-size: 12px; font-weight: 600;">
-                    ⚠️ Microphone recording sample missing. Speak some script lines!
-                   </div>""",
-                gr.HTML(visible=False),
-                gr.HTML(visible=False),
-                gr.Audio(visible=False),
-                gr.Button(visible=False)
-            )
-
-        progress(0, desc="Extracting speech samples patterns...")
-        time.sleep(1.0)
-        progress(0.3, desc="Filtering ambient air-con noise frequencies...")
-        time.sleep(1.2)
-        progress(0.65, desc="Mapping vocal vocal tracts formant spaces & frequencies...")
-        time.sleep(1.5)
-        progress(0.9, desc="Validating speech prosody & standard conversational matching...")
-        time.sleep(1.0)
-
-        preview_text = f"&ldquo;Hello! I have created my brand new clone under '{v_name}'. Ready to narrate any classical story inside your library shelves.&rdquo;"
-        avatar = "👩" if v_gender == "Female" else "👨"
-
-        cloned_card_html = f"""
-        <div style="background: white; border: 1px solid #ebdccb; padding: 24px; border-radius: 16px; margin: 16px 0;">
-            <div style="display: flex; gap: 16px; align-items: center; margin-bottom: 12px;">
-                <div style="width: 48px; height: 48px; border-radius: 50%; background: #944a00; color: white; display: flex; align-items: center; justify-content: center; font-size: 24px;">
-                    {avatar}
-                </div>
-                <div>
-                    <h4 class="serif-header" style="font-size: 16px; margin: 0;">{v_name} <span style="font-size: 9px; background: #f0fdf4; color: #16a34a; padding: 2px 6px; border-radius: 4px; font-weight:700;">Cloned successfully</span></h4>
-                    <p style="font-size: 11px; color:#6f6257; margin-top:2px;">Synthesized today • Calibrated for Classical Audiobooks</p>
-                </div>
-            </div>
-            <div style="background:#FAF7F2; border-left: 3px solid #f5841f; padding: 10px; font-family: Georgia, serif; font-style: italic; font-size: 12px; color: #1c1c19;">
-                {preview_text}
-            </div>
-        </div>
-        """
-
-        return (
-            gr.HTML(visible=False),
-            gr.HTML(visible=False),
-            gr.HTML(value=cloned_card_html, visible=True),
-            gr.Audio(visible=True),
-            gr.Button(visible=True)
-        )
-
-    extract_btn.click(
-        animate_cloning_pipeline,
-        inputs=[new_voice_name, new_voice_gender, mic_recorder],
-        outputs=[cloning_progress_msg, loading_spinner, voice_cloning_success_panel, voice_sample_preview_widget, add_to_library_btn]
-    )
-
-    # 4. Add cloned voice to inventory
-    def save_new_cloned_voice(v_name, v_gender, list_voices):
-        avatar = "👩" if v_gender == "Female" else "👨"
-        new_voice_item = {
-            "id": f"v-{time.time()}",
-            "name": v_name,
-            "avatar_url": avatar,
-            "description": f"Custom cloned {v_gender.lower()} companion voice. Highly optimized.",
-            "gender": v_gender,
-            "created_date": "2026-06-06",
-            "status": "ready"
-        }
-        updated = [new_voice_item] + list_voices
-        return (
-            updated,
-            render_cloned_voices_html(updated),
-            gr.HTML(visible=True, value="""<div style="text-align: center; padding: 32px 0;"><span style="font-size:42px;">🎙️</span><p style="margin-top:12px; font-size:14px; color:#6f6257;">Vocal profile saved successfully!</p></div>"""),
-            gr.HTML(visible=False),
-            gr.HTML(visible=False),
-            gr.Audio(visible=False),
-            gr.Button(visible=False),
-            gr.Textbox(value="")
-        )
-
-    add_to_library_btn.click(
-        save_new_cloned_voice,
-        inputs=[new_voice_name, new_voice_gender, voices_state],
-        outputs=[voices_state, cloned_voices_list_grid, cloning_progress_msg, loading_spinner, voice_cloning_success_panel, voice_sample_preview_widget, add_to_library_btn, new_voice_name]
-    )
-
-    # 5. Play button — streams TTS audio chunk by chunk
-    def stream_tts(tts_chunks, paras):
-        _status_playing = """
-            <div style="margin-top: 12px; display: flex; align-items: center; gap: 10px; justify-content: center;">
-                <span style="width: 8px; height: 8px; border-radius: 50%; background: #4ade80; display: inline-block;"></span>
-                <span style="font-size: 11px; color: #4ade80; font-family: monospace;">PLAYING</span>
-            </div>
-        """
-        _status_done = """
-            <div style="margin-top: 12px; display: flex; align-items: center; gap: 10px; justify-content: center;">
-                <span style="width: 8px; height: 8px; border-radius: 50%; background: #94a3b8; display: inline-block;"></span>
-                <span style="font-size: 11px; color: #94a3b8; font-family: monospace;">DONE</span>
-            </div>
-        """
-
-        if not tts_chunks:
-            yield None, _status_done, "<div style='text-align:center;font-size:10px;color:#64748b;font-family:monospace;margin-top:8px;'>No content loaded</div>", gr.Button(visible=True), gr.Button(visible=False), gr.Button(visible=False)
-            return
-
-        n = len(tts_chunks)
-        # Immediately show PLAYING state
-        yield None, _status_playing, f"<div style='text-align:center;font-size:10px;color:#4ade80;font-family:monospace;margin-top:8px;'>Generating chunk 1 / {n}…</div>", gr.Button(visible=False), gr.Button(visible=True), gr.Button(visible=False)
-
-        for sample_rate, wav, i, total, err in generate_audio_stream(tts_chunks):
-            if err:
-                yield None, f"<div style='color:#ef4444;font-size:11px;'>Error on chunk {i+1}: {err}</div>", "", gr.Button(visible=True), gr.Button(visible=False), gr.Button(visible=False)
-                return
-            next_label = f"chunk {i+2} / {total}" if i + 1 < total else "last chunk"
-            chunk_html = f"<div style='text-align:center;font-size:10px;color:#4ade80;font-family:monospace;margin-top:8px;'>▶ Playing chunk {i+1} / {total} — generating {next_label}</div>"
-            yield (sample_rate, wav), _status_playing, chunk_html, gr.Button(visible=False), gr.Button(visible=True), gr.Button(visible=True)
-
-        done_html = f"<div style='text-align:center;font-size:10px;color:#94a3b8;font-family:monospace;margin-top:8px;'>✅ {n} chunks complete</div>"
-        yield None, _status_done, done_html, gr.Button(visible=True), gr.Button(visible=False), gr.Button(visible=False)
-
-    play_btn.click(
-        stream_tts,
-        inputs=[tts_chunks_state, paragraphs_state],
-        outputs=[player_audio_control, player_status_bar, chunk_status, play_btn, pause_btn, ask_btn]
-    )
-
-    # 6. Pause button — PAUSED state
-    def enter_paused_state(slider_val, paras):
-        total = len(paras) if paras else 1
-        chunk_html = f"""<div style="margin-top: 8px; font-size: 10px; color: #f59e0b; font-family: monospace; text-align: center;">Paragraph {int(slider_val) + 1} / {total} — paused</div>"""
-        status_html = """
-            <div style="margin-top: 12px; display: flex; align-items: center; gap: 10px; justify-content: center;">
-                <span style="width: 8px; height: 8px; border-radius: 50%; background: #f59e0b; display: inline-block;"></span>
-                <span style="font-size: 11px; color: #f59e0b; font-family: monospace;">PAUSED</span>
-            </div>
-        """
-        return (
-            status_html,
-            chunk_html,
-            gr.Button(visible=True),
-            gr.Button(visible=False),
-        )
-
-    pause_btn.click(
-        enter_paused_state,
-        inputs=[timeline_slider, paragraphs_state],
-        outputs=[player_status_bar, chunk_status, play_btn, pause_btn]
-    )
-
-    # 7. Timeline slider → highlight current paragraph
-    def update_story_highlight(slider_val, paras):
-        idx = int(slider_val)
-        total = len(paras)
-        chunk_html = f"""<div style="margin-top: 8px; font-size: 10px; color: #64748b; font-family: monospace; text-align: center;">Paragraph {idx + 1} / {total}</div>"""
-        return render_story_text(paras, idx), chunk_html
-
-    timeline_slider.change(update_story_highlight, inputs=[timeline_slider, paragraphs_state], outputs=[story_text_display, chunk_status])
-
-    # 8. Ask button — PAUSED-ASKING state
-    def enter_asking_state():
-        status_html = """
-            <div style="margin-top: 12px; display: flex; align-items: center; gap: 10px; justify-content: center;">
-                <span style="width: 8px; height: 8px; border-radius: 50%; background: #f59e0b; display: inline-block; animation: pulse 1s infinite;"></span>
-                <span style="font-size: 11px; color: #f59e0b; font-family: monospace;">PAUSED — ASKING</span>
-            </div>
-        """
-        return (
-            status_html,
-            gr.Button(visible=False),
-            gr.Button(visible=False),
-            gr.Button(visible=False),
-            gr.Button(visible=True),
-            gr.HTML(visible=True),
-            gr.Group(visible=True),
-            gr.HTML(visible=False),
-            gr.Audio(visible=False),
-        )
-
-    ask_btn.click(
-        enter_asking_state,
-        inputs=[],
-        outputs=[player_status_bar, play_btn, pause_btn, ask_btn, resume_btn, qa_panel, qa_input_group, answer_display, answer_audio]
-    )
-
-    # 9. Submit question
-    def handle_question_submit(question_txt, question_audio_path):
-        if not question_txt.strip() and question_audio_path is None:
-            answer_html = """
-                <div style="padding: 10px; background: #fef2f2; border: 1px solid #fecaca; border-radius: 10px; font-size: 12px; color: #991b1b;">
-                    ⚠️ Please type a question or record one with the microphone.
-                </div>
-            """
-            return answer_html, gr.Audio(visible=False)
-
-        q_text = question_txt.strip() if question_txt.strip() else "(spoken question)"
-        mock_answer = "That's a great question! The story tells us something very special about that. Keep listening to discover the full answer as the adventure unfolds."
-
-        answer_html = f"""
-            <div style="margin-top: 12px; padding: 16px; background: rgba(240,253,244,0.1); border: 1px solid rgba(187,247,208,0.3); border-radius: 14px;">
-                <div style="font-size: 10px; font-weight: 700; text-transform: uppercase; color: #4ade80; margin-bottom: 6px;">Answer in Narrator's Voice</div>
-                <div style="font-family: 'Playfair Display', Georgia, serif; font-style: italic; color: #FAF7F2; font-size: 13px; line-height: 1.6;">
-                    &ldquo;{mock_answer}&rdquo;
+                    """)
+                    google_log_btn = gr.Button("🗝️ Continue with Google Account", variant="secondary")
+                    gr.HTML("<span style='font-size: 11px; color:#564336; opacity: 0.5; display:block; margin: 10px 0;'>— OR ENTER MANUALLY —</span>")
+                    sub_email = gr.Textbox(placeholder="Email address", container=False)
+                    sub_pass = gr.Textbox(placeholder="Password", type="password", container=False)
+                    login_email_btn = gr.Button("Sign In to VoiceBook Database", elem_classes="glow-btn")
+                    gr.HTML("<p style='font-size: 12px; color: #564336; margin-top: 20px;'>아직 계정이 없으신가요? <u style='cursor:pointer; color:#944a00; font-weight:bold;'>회원 가입</u></p>")
+
+            # 샌드박스 상태 토글링 핸들러
+            def toggle_404():
+                return gr.update(visible=True), gr.update(visible=False), gr.update(visible=False), gr.update(visible=False)
+            def toggle_empty():
+                return gr.update(visible=False), gr.update(visible=True), gr.update(visible=False), gr.update(visible=False)
+            def toggle_offline():
+                return gr.update(visible=False), gr.update(visible=False), gr.update(visible=True), gr.update(visible=False)
+            def toggle_login():
+                return gr.update(visible=False), gr.update(visible=False), gr.update(visible=False), gr.update(visible=True)
+            
+            btn_tr_404.click(fn=toggle_404, outputs=[view_404, view_empty, view_offline, view_login])
+            btn_tr_empty.click(fn=toggle_empty, outputs=[view_404, view_empty, view_offline, view_login])
+            btn_tr_offline.click(fn=toggle_offline, outputs=[view_404, view_empty, view_offline, view_login])
+            btn_tr_login.click(fn=toggle_login, outputs=[view_404, view_empty, view_offline, view_login])
+
+    # ==========================================
+    # 5. 음성 미리보기 바텀시트 / 동적 낭독 윈도우 프리뷰 (Page 5)
+    # ==========================================
+    gr.HTML("<div style='height: 40px;'></div>")
+    
+    with gr.Accordion("🎧 실시간 음성 복제 낭독 윈도우 (Voice Transcript Sync Dashboard - Tab 5 및 bottom sheet 연동)", open=True):
+        with gr.Row():
+            with gr.Column(scale=4, style="text-align: center;"):
+                gr.HTML("""
+                    <div style="position: relative; width: 100px; height:100px; margin: 15px auto 10px auto;">
+                        <div class="speech-pulse-ring" style="position: absolute; width:100%; height:100%;"></div>
+                        <img src="https://images.unsplash.com/photo-1544005313-94ddf0286df2?auto=format&fit=crop&q=80&w=100" style="width: 100%; height: 100%; border-radius: 50%; object-fit: cover; border: 3px solid #fff; box-shadow: 0 4px 10px rgba(0,0,0,0.15); relative z-10;" />
+                    </div>
+                """)
+                preview_narrator_name = gr.Markdown("### Mom's Voice (엄마 음성 모델)\n`Calibrated in Jan 2026`")
+                preview_test_audio_btn = gr.Button("🔊 12초 모의 샘플 나레이션 청취", variant="primary")
+            
+            with gr.Column(scale=8):
+                gr.HTML("""<span style="font-size: 11px; background: #944a00; color: #fff; padding: 2px 8px; border-radius: 4px; font-weight: bold; text-transform: uppercase;">Live Transcript Karaoke Sync</span>""")
+                sync_para = gr.HTML("""
+                    <p style="font-size: 1.35rem; line-height: 1.6; color: #1c1c19; font-style: italic; margin-top: 10px; font-family: 'Playfair Display', serif;">
+                        "Once upon a time, in a land far, far away, there 
+                        <span style="background: #ffdcc6; color: #944a00; font-weight: bold; padding: 0 4px; border-radius: 4px;">lived</span> 
+                        a little dreamer who loved to explore the stars..."
+                    </p>
+                """)
+                
+                # 실시간 동적 대사 노래방식 변경 시뮬레이터
+                karaoke_timer_btn = gr.Button("🗣️ 낭독 진행 상태 가상 시뮬레이션 돌려보기")
+                
+                def rotate_karaoke():
+                    phrases = [
+                        'Once upon a time, in a land far, far away, there <span style="background: #ffdcc6; color: #944a00; font-weight: bold; padding: 0 4px; border-radius: 4px;">lived</span> a little dreamer...',
+                        'Once upon a time, in a land far, far away, there lived a <span style="background: #ffdcc6; color: #944a00; font-weight: bold; padding: 0 4px; border-radius: 4px;">little</span> dreamer...',
+                        'Once upon a time, in a land far, far away, there lived a little <span style="background: #ffdcc6; color: #944a00; font-weight: bold; padding: 0 4px; border-radius: 4px;">dreamer</span> who loved...',
+                        'Once upon a time, in a land far, far away, there lived a little dreamer who <span style="background: #ffdcc6; color: #944a00; font-weight: bold; padding: 0 4px; border-radius: 4px;">loved</span> to explore...'
+                    ]
+                    for pr in phrases:
+                        time.sleep(0.9)
+                        yield pr
+                
+                karaoke_timer_btn.click(fn=rotate_karaoke, outputs=[sync_para])
+
+    # ==========================================
+    # 6. 하단 고정형 오디오 재생 및 대시보드 상태 패널
+    # ==========================================
+    gr.HTML("<div style='height: 120px;'></div>") # 하단 고정 바가 올라올 여백 확보
+    
+    with gr.Row(elem_classes="bottom-player-bar"):
+        with gr.Column(scale=3, min_width=150):
+            current_playing_title = gr.HTML("""
+                <div style="display: flex; align-items: center; gap: 12px; margin-top: 5px;">
+                    <img src="https://images.unsplash.com/photo-1544947950-fa07a98d237f?auto=format&fit=crop&q=80&w=100" style="width: 48px; height: 48px; border-radius: 6px; object-fit: cover;" />
+                    <div style="line-height: 1.2;">
+                        <h5 class="editorial-title" style="margin: 0; font-size: 14px; font-weight: bold;">The Secret Garden</h5>
+                        <span style="font-size: 11px; color: #944a00; font-weight: bold;">🎙️ Mom's Voice AI</span>
+                    </div>
                 </div>
-                <div style="margin-top: 8px; font-size: 10px; color: #94a3b8;">
-                    Q: <em>{q_text}</em>
+            """)
+        with gr.Column(scale=6, min_width=320):
+            with gr.Row(style="justify-content: center;"):
+                stop_sim_btn = gr.Button("◀◀", size="sm", variant="secondary")
+                play_sim_btn = gr.Button("▶ / ⏸ (재생 설정 시뮬레이터)", size="sm", variant="primary")
+                skip_sim_btn = gr.Button("▶▶", size="sm", variant="secondary")
+            
+            with gr.Row():
+                player_progress_pct = gr.Slider(minimum=0, maximum=100, value=35, label="재생 구역 타임라인 (Scrubber)", interactive=True)
+                
+            def process_player_toggle(current_val):
+                gr.Info("오디오 재생기가 정상적으로 연동 작동중입니다.")
+                return 42 if current_val < 42 else 12
+
+            play_sim_btn.click(fn=process_player_toggle, inputs=[player_progress_pct], outputs=[player_progress_pct])
+            
+        with gr.Column(scale=3, min_width=150):
+            gr.HTML("""
+                <div style="text-align: right; display:flex; flex-direction:column; justify-content:center; height:100%; margin-top: 10x;">
+                    <span style="font-size: 12px; color: #1c1c19; font-weight: bold; text-decoration: underline; cursor: pointer;">오디오 음량 조절 및 볼륨 믹싱</span>
+                    <span style="font-size: 11px; color:#564336; opacity:0.8;">출력 장치: Airpods Pro (Bluetooth)</span>
                 </div>
-            </div>
-        """
-        return answer_html, gr.Audio(value="sample_sounds/cloned_preview.wav", visible=True)
-
-    submit_question_btn.click(
-        handle_question_submit,
-        inputs=[question_text, question_audio],
-        outputs=[answer_display, answer_audio]
-    )
-
-    # 10. Resume button — back to PLAYING
-    def enter_resume_state():
-        status_html = """
-            <div style="margin-top: 12px; display: flex; align-items: center; gap: 10px; justify-content: center;">
-                <span style="width: 8px; height: 8px; border-radius: 50%; background: #4ade80; display: inline-block;"></span>
-                <span style="font-size: 11px; color: #4ade80; font-family: monospace;">PLAYING</span>
-            </div>
-        """
-        return (
-            status_html,
-            gr.Button(visible=False),
-            gr.Button(visible=True),
-            gr.Button(visible=True),
-            gr.Button(visible=False),
-            gr.HTML(visible=False),
-            gr.Group(visible=False),
-            gr.HTML(visible=False),
-            gr.Audio(visible=False),
-            gr.Textbox(value=""),
-        )
-
-    resume_btn.click(
-        enter_resume_state,
-        inputs=[],
-        outputs=[player_status_bar, play_btn, pause_btn, ask_btn, resume_btn, qa_panel, qa_input_group, answer_display, answer_audio, question_text]
-    )
-
-    # 11. Story-finished check
-    def check_story_finished(slider_val, paras):
-        if paras and int(slider_val) >= len(paras) - 1:
-            return gr.HTML(visible=True)
-        return gr.HTML(visible=False)
-
-    timeline_slider.change(check_story_finished, inputs=[timeline_slider, paragraphs_state], outputs=[story_finished_panel])
-
-    # 12. Sandbox outage toggle
-    def toggle_outage_sandbox(checked):
-        if checked:
-            return gr.HTML(visible=True), gr.Tabs(visible=False)
-        else:
-            return gr.HTML(visible=False), gr.Tabs(visible=True)
-
-    offline_toggle.change(toggle_outage_sandbox, inputs=[offline_toggle], outputs=[system_error_modal, main_tabs])
+            """)
 
+# ------------------------------------------
+# 7. 엔트리 포인트 기동 
+# ------------------------------------------
 if __name__ == "__main__":
-    demo.queue().launch(allowed_paths=[str(Path(__file__).parent / "assets")])
+    demo.launch()

docs/tts-module-spec.md

@@ -1,21 +0,0 @@
-refer to test_modules/app_supertonic_tts_demo.py
-
-- use supertonic tts library
-- in this demo, input text is generated to speech data using supertonic.TTS
-- text is firstly divided into multiple chunk text by statements and stored in buffer list
-- and TTS generation is running for the list of text chunks
-- this is to generate audio quickly for long text book.
-
-TODO
-- make tts.py and make module refering to app_supertonic_tts_demo.py
-- In library menu, "Tap to play" button is clicked and the book text is chuncked and stored in buffer list.
-- user click the play button and the text chunk list is converted to audio one by one.
-
-
-package dependencies
-
-# Supertonic TTS
-supertonic>=1.3.1
-soundfile>=0.12.0
-onnxruntime>=1.18.0
-huggingface-hub>=0.23.0

future_mobile_app_considerations.md

@@ -1,143 +0,0 @@
-# Future Mobile App Considerations
-
-## Purpose
-
-This note captures future mobile deployment guidance for ReadBookMom. The current hackathon plan should remain a Hugging Face Spaces demo, with mobile treated as a later product direction.
-
-## Recommendation
-
-Do not plan the first mobile version as a fully on-device app running all models locally. A hybrid mobile app is more realistic for reasonable latency, battery life, interruption behavior, and device coverage.
-
-For the mobile app, use the phone as the recording, playback, interruption, and story interaction surface. Keep cloned-voice TTS and Q&A generation on a GPU backend until the models and runtime stack are proven on target devices.
-
-The mobile version should inherit the current PRD direction: interruptible chunked streaming with a tap-to-Ask flow. The first mobile product should not attempt always-listening voice barge-in.
-
-## Model Fit For Mobile
-
-| Model | Mobile Fit | Notes |
-|---|---|---|
-| Qwen2.5-3B-Instruct | Possible on high-end phones only | With 4-bit quantization, it may fit on flagship devices, but latency, RAM pressure, battery drain, and thermal throttling will vary by device and runtime. |
-| Whisper-small | Borderline | Better suited to server or desktop-class environments. For mobile latency, prefer native iOS/Android speech APIs, Whisper-tiny, or Whisper-base. |
-| QWEN-TTS-0.6B | Hardest to deploy locally | Voice cloning TTS adds audio pipeline cost beyond parameter count. On-device latency may be poor unless a mobile-optimized runtime path is available. |
-
-## Mobile Interaction Model
-
-The mobile app should behave like a smart audiobook player:
-
-```text
-Story chunk is playing
--> child taps Ask
--> app pauses local playback immediately
--> question is captured as text or voice
--> backend generates a short grounded answer
--> answer audio plays in the cloned voice
--> story resumes from the saved position
-```
-
-Button-based interruption is the recommended first version. True voice barge-in, where the child talks over narration and the app detects it automatically, should remain a later research item because it requires echo cancellation, voice activity detection, full-duplex audio handling, and careful privacy UX.
-
-## Mobile Architecture
-
-| Layer | Responsibility | Recommendation |
-|---|---|---|
-| Mobile app | Recording, playback, Ask interruption, local state, local cache | Native iOS/Android app or React Native/Flutter with native audio modules. |
-| Backend API | Voice profile session, story chunk generation, Q&A answer generation, answer TTS | GPU backend using the same model stack as the Space demo. |
-| Streaming/control channel | Request chunks, pause/resume, cancel queued work, receive generation status | WebSocket for bidirectional control; REST plus polling is acceptable for narration-only prototyping but will not support the full interrupt/answer/resume loop reliably. |
-| Audio delivery | Stream or download generated chunks | Prefer short chunk files with signed URLs and local prefetch cache. |
-| Session state | Track story and interruption position | Store `story_id`, `voice_session_id`, `current_chunk_index`, playback state, and cache keys. |
-
-The phone should own playback responsiveness. The server can cancel or deprioritize queued generation, but the app should pause current audio locally without waiting for backend confirmation.
-
-## Deployment Options
-
-### Option 1: Cloud-Backed Mobile App
-
-The mobile app handles recording, story selection, interruption, playback, and local chunk caching. ASR, Q&A, and cloned-voice TTS run on a GPU backend.
-
-**Best for:** first production prototype, hackathon follow-up, broad device support.
-
-**Pros:** fastest path to reliable model latency, easier model updates, works across more phones.
-
-**Cons:** requires backend hosting, network connectivity, and clear privacy messaging.
-
-### Option 2: Hybrid Mobile App
-
-The app uses native or lightweight on-device ASR for the child's question, while Q&A and voice cloning TTS run on a backend. The phone manages interruptible chunk playback, local pause/resume, and cached story chunks.
-
-**Best for:** better perceived latency while keeping heavy voice generation off-device.
-
-**Pros:** practical performance, less backend work for transcription, smoother UX, and faster interruption response.
-
-**Cons:** still depends on server-side TTS and model hosting.
-
-### Option 3: Fully On-Device App
-
-The phone runs ASR, Q&A, voice cloning TTS, chunk generation, and playback locally.
-
-**Best for:** long-term privacy-first product direction on selected flagship devices.
-
-**Pros:** strongest offline and privacy story.
-
-**Cons:** highest engineering risk; likely issues with memory, heat, battery drain, app size, cold start, audio session complexity, and inconsistent latency across devices.
-
-## Suggested Mobile Stack
-
-| Capability | Near-Term Mobile Choice | Long-Term On-Device Candidate |
-|---|---|---|
-| Q&A | Backend `Qwen/Qwen2.5-3B-Instruct` | Quantized `Qwen2.5-1.5B-Instruct` or quantized `Qwen2.5-3B-Instruct` on flagship devices |
-| ASR | Native iOS/Android speech APIs or backend Whisper | Whisper-tiny/base through a mobile-optimized runtime |
-| Voice cloning TTS | Backend QWEN-TTS-0.6B | Mobile-optimized TTS/voice clone model if quality and latency are proven |
-| Story narration | Backend chunk generation with mobile playback and local chunk cache | Pre-generate and store locally after first generation |
-| Story Q&A audio | Generate short answers on demand | On-device Q&A plus server or local lightweight TTS |
-| Interruption | Tap-to-Ask pauses local playback immediately | Voice barge-in after echo cancellation and VAD are proven |
-
-## Latency Expectations
-
-| Flow | Target | Mobile Strategy |
-|---|---|---|
-| Story start | First chunk starts in 3-6 seconds on a good network | Generate the first chunk server-side, then prefetch the next chunks. |
-| Narration interruption | Local playback pauses within 500ms after Ask tap | Pause on-device immediately; backend cancellation is best effort. |
-| Child question transcription | 1-2 seconds | Prefer native mobile speech APIs or a tiny ASR model. |
-| Q&A text answer | 1-3 seconds | Use short prompts, 1-2 sentence answers, and backend Qwen2.5-3B-Instruct. |
-| Spoken Q&A answer | Starts in 4-8 seconds after question submit | Keep answer text short and generate TTS server-side. |
-| Story resume | Under 1 second when next chunk is cached | Resume from saved chunk position; fetch missing chunks in the background. |
-| Cache miss resume | 2-5 seconds | Show a lightweight loading state while the next chunk is generated or downloaded. Play a short filler clip (“Hmm, let me find my place…”) pre-synthesized in the cloned voice during voice setup, so the child hears the parent’s voice instead of silence. |
-
-Mobile latency depends heavily on network quality. The app should show resilient playback states instead of assuming the backend will always meet desktop demo timing.
-
-## Mobile Constraints
-
-| Constraint | Product Impact | Recommendation |
-|---|---|---|
-| Network jitter | Chunks may arrive late or out of order. | Prefetch the next 1-2 chunks and keep a small playback buffer. |
-| Battery and thermals | Continuous local ASR or on-device LLM/TTS can drain battery quickly. | Keep heavy models server-side for v1; avoid always-on microphone. |
-| Audio session complexity | Recording while audio is playing is fragile on mobile. | Pause playback before recording the question; resume after answer playback. |
-| Echo cancellation | Open-mic interruption can capture the story audio instead of the child. | Use tap-to-Ask first; research VAD and echo cancellation later. |
-| App lifecycle | Incoming calls, lock screen, and backgrounding can interrupt playback. | Treat v1 as foreground-first; persist playback state and chunk cache. |
-| Storage | Cached voice/story audio can grow quickly. | Cache by voice session, story ID, chunk index, and model version with TTL cleanup. |
-| App size | A thin cloud-backed client is ~20 MB. A hybrid app with on-device ASR (Whisper-tiny) may reach 100–200 MB. A fully on-device build with all models could exceed 4 GB. | Start thin; gate on-device model downloads behind user opt-in. |
-| Privacy | Family voice data and child questions are sensitive. | Make upload, retention, deletion, and cache behavior explicit. |
-
-## Product Implications
-
-- The first mobile app should be a hybrid app, not a full local AI runtime.
-- The phone should own playback state and interruption responsiveness.
-- Privacy messaging must be explicit: explain what audio is sent to the backend, how long it is retained, and whether generated voice samples are cached.
-- If offline mode becomes a requirement, treat it as a separate research milestone, not a launch feature. As a conscious tradeoff, v1 has no offline fallback — even a cached-story-only offline mode would add significant complexity.
-- Device qualification matters. Fully on-device AI should start with a short list of supported flagship phones.
-- Chunk prefetching and caching are key to making bedtime story playback and resume feel instant.
-- Always-listening barge-in should not be promised until echo cancellation, VAD, and mobile privacy UX are proven.
-
-## Future Research Tasks
-
-1. Benchmark quantized Qwen2.5-1.5B-Instruct and Qwen2.5-3B-Instruct on representative iOS and Android devices.
-2. Compare native speech APIs with Whisper-tiny/base for child speech accuracy and latency.
-3. Test whether QWEN-TTS-0.6B has a viable mobile runtime path or whether server-side TTS remains required.
-4. Prototype backend chunk generation and mobile prefetch cache keyed by story ID, voice profile, chunk index, and model version.
-5. Prototype tap-to-Ask interruption with local pause, backend cancellation/deprioritization, answer playback, and story resume.
-6. Measure behavior under poor mobile networks, app backgrounding, and audio session interruptions.
-7. Define privacy and retention policy before any real family audio is stored.
-
-## Decision
-
-For the next phase, keep the model stack server-side and design the mobile app as a polished hybrid client with native playback, local chunk cache, tap-to-Ask interruption, and resume state. Revisit fully on-device deployment only after benchmarking smaller Q&A models, mobile ASR options, mobile-ready voice cloning TTS, and reliable barge-in audio handling.

mission.md

@@ -1,102 +0,0 @@
-# Mission
-
-## Product Vision
-
-**ReadBookMom** — a parent records a short voice sample, then a bedtime story and story Q&A are spoken back in that parent's cloned voice. The demo runs on local models inside a Gradio app on Hugging Face Spaces.
-
-## Problem
-
-Parents can't always be there at bedtime. Children want to hear *their parent's voice* reading to them. Existing TTS is generic and impersonal, while voice cloning APIs are expensive and require sending private family audio to third parties.
-
-## Demo Loop
-
-```
-Parent records 15s of voice → Pick a story → Story starts in parent's voice
-                                    ↓
-                    Child taps Ask mid-story → Narration pauses
-                                    ↓
-                  Child asks a question → Hears answer in parent's voice
-                                    ↓
-              Resume story from the same position (or ask another question)
-                                    ↓
-                      Story finishes → Show "Pick another story" prompt
-```
-
-Latency and natural interruption are part of the demo promise: the story should start quickly, pause cleanly when the child wants to ask something, answer in the cloned voice, then resume without losing the story position. The child may ask multiple questions in a row before resuming. When the last chunk finishes playing, the app returns to the story selection screen.
-
-**Demo time budget:** A 3-minute live walkthrough allows ~2 Q&A rounds (each round ≈ 15s of dead air: pause + ask + wait + answer + resume). Plan the demo script around 1–2 questions placed at natural story moments.
-
-## Hackathon Goal (2 days)
-
-Ship a working Hugging Face Space that demonstrates:
-1. **Voice cloning** — parent uploads/records a short audio clip
-2. **Interruptible story narration** — QWEN-TTS-0.6B streams paragraph-sized chunks in the cloned voice
-3. **Voice Q&A during narration** — child taps Ask, narration pauses, Qwen2.5-3B-Instruct answers from the story context, then QWEN-TTS-0.6B speaks the answer in the cloned voice
-
-## Target Demo User
-
-A parent at a laptop who records their voice, picks a short story, and shows their child the result.
-
-## Success Criteria (Hackathon)
-
-| Criteria | Target |
-|---|---|
-| Voice clone from ≤ 30s audio | 2 of 3 listeners identify the voice in a blind A/B test |
-| Story start latency | First streamed audio chunk in ≤ 5s |
-| Narration interruption | Ask tap pauses playback in ≤ 500ms and preserves story position |
-| Cached story replay | Starts immediately after first generation |
-| Q&A answer (spoken, live) | Spoken answer starts in ≤ 8s from question submit (known compromise — a young child may lose attention) |
-| Q&A answer (spoken, pre-generated) | Sub-1s for anticipated questions matched from background Q&A cache |
-| Story resume latency | Resume from paused position in ≤ 1s when next chunk is cached |
-| Works on HF Spaces | Public link, no local setup needed |
-| Demo length | 3-minute live walkthrough |
-| Privacy posture | Voice and Q&A stay on the Space runtime |
-
-## Scope
-
-**In scope:**
-- Upload/record parent voice sample (15–30s)
-- Select from 10 pre-loaded short stories (public domain, sourced from Project Gutenberg)
-- Play story narrated in cloned voice with interruptible chunked streaming
-- Pause narration through an Ask button, preserve the current story chunk, answer, then resume
-- Cache generated narration per voice session and story
-- Ask a question about the story, receive a grounded 1–2 sentence Qwen2.5-3B-Instruct answer, and hear it in the cloned voice
-- Clean, child-friendly UI (Google Stitch-inspired via gr.Server)
-
-**Out of scope:**
-- User accounts, auth, database
-- Offline mode, progress tracking
-- Multiple languages
-- Always-listening voice barge-in, echo cancellation, and open-mic interruption
-- COPPA compliance (demo only)
-
-## Guardrails (Lite)
-
-| Constraint | Implementation |
-|---|---|
-| Content grounding | Qwen2.5-3B-Instruct receives the selected story text plus a strict answer-from-story instruction |
-| Voice privacy | All inference local on HF Space GPU — no audio leaves the server |
-| Child safety | Pre-curated stories only; no user-uploaded content |
-
-## Latency Strategy
-
-| Bottleneck | Strategy |
-|---|---|
-| Voice setup | Compute and cache the voice representation immediately after recording. |
-| Story narration | Use interruptible chunked streaming: generate the first paragraph chunk, play it immediately, then continue generating queued chunks. |
-| Interruption | Add an Ask state that pauses playback, cancels or deprioritizes queued narration generation, and stores the current chunk index. |
-| Story replay | Cache full generated narration by voice session and story ID. |
-| Q&A context | Send the current story position plus the most relevant story passages to Qwen2.5-3B-Instruct instead of the full story when possible. |
-| Q&A length | Cap answers to 1–2 short child-friendly sentences before sending to TTS. |
-| Pre-generated Q&A | While each chunk plays, generate 2–3 anticipated Q&A pairs with audio in the background. Match incoming questions against the cache for sub-1s responses; fall back to live generation on miss. |
-| Story resume | Resume from the paused chunk after the spoken answer; use cached next chunks when available. |
-| Voice question input | Load ASR only when audio questions are used; text questions bypass ASR. |
-
-## Design Review Notes
-
-| Topic | Critique | Upgrade |
-|---|---|---|
-| Privacy | An external LLM API would weaken the privacy story even if audio stayed local. | Use Qwen2.5-3B-Instruct for local story Q&A so the demo has one clear privacy narrative. |
-| Latency | A 3B-class Q&A model is a better fit for the demo loop than an 8B-class model, but TTS and interruption responsiveness remain the user-visible bottlenecks. | Cache voice setup, stream chunked narration, make playback cancellable, cap Q&A output, and use 4-bit or 8-bit loading on T4. |
-| Demo clarity | Voice cloning, narration, ASR, and Q&A can feel like too many moving parts. | Present the loop as three simple actions: record, listen, ask. |
-

requirements.txt

@@ -1,14 +0,0 @@
-gradio==5.35.0
-transformers
-torch
-accelerate
-bitsandbytes
-soundfile
-numpy
-
-
-# Supertonic TTS
-supertonic>=1.3.1
-soundfile>=0.12.0
-onnxruntime>=1.18.0
-huggingface-hub>=0.23.0

sprint.md

@@ -1,142 +0,0 @@
-# Sprint Plan — 2-Day Hackathon
-
-## Goal
-Ship a public Hugging Face Space: parent clones voice → story streams in that voice → child can interrupt, ask, hear the answer, and resume.
-
----
-
-## Day 1: Core Pipeline (Get It Working)
-
-### Morning (4h) — Voice Clone + TTS
-
-| # | Task | Time | Done |
-|---|---|---|---|
-| 1 | Set up repo: `app.py`, `requirements.txt`, `stories/` | 30m | ☑ |
-| 2 | Load QWEN-TTS-0.6B locally, test basic TTS (text → audio) | 1h | ☐ |
-| 3 | Implement voice cloning and cache voice representation after recording | 1.5h | ☐ |
-| 4 | Add 10 short stories as `.txt` files (public domain, from Project Gutenberg) | 30m | ☑ |
-| 5 | Wire up: pick story → stream first narration chunk, track chunk index, cache story audio | 1h | ☐ |
-
-**Checkpoint:** Can generate a story audio file in a cloned voice from CLI.
-
-### Afternoon (4h) — Gradio UI + Q&A
-
-| # | Task | Time | Done |
-|---|---|---|---|
-| 6 | Build Gradio app with 3 tabs (Clone, Listen, Ask) | 1h | ☐ |
-| 7 | Tab 1 (Clone): `gr.Audio` record/upload + preview button | 45m | ☐ |
-| 8 | Tab 2 (Listen): story dropdown + play/pause/resume controls for streamed chunks | 45m | ☐ |
-| 9 | Add on-demand ASR for child voice input; use lighter ASR fallback if needed | 30m | ☐ |
-| 10 | Tab 3 (Ask): interrupt narration → short grounded Qwen answer → TTS → resume story | 2h | ☐ |
-| 10a | Pre-generate 2–3 anticipated Q&A pairs per chunk during narration playback (background task) | 30m | ☐ |
-
-**Checkpoint:** Full loop works locally — clone → listen → interrupt → ask → resume. Ugly but functional.
-
-**Day 1 Overflow Plan:** If the afternoon runs past 8h, cut Task 9 (on-demand ASR) and rely on text-only questions. CSS polish (Tasks 12–14) is the next cut candidate on Day 2.
-
----
-
-## Day 2: Polish + Deploy (Make It Demo-Ready)
-
-### Morning (4h) — UI Polish (Google Stitch)
-
-| # | Task | Time | Done |
-|---|---|---|---|
-| 11 | Set up `gr.Server` with custom static files (`static/style.css`) | 30m | ☐ |
-| 12 | Stitch-style CSS: color palette, card layout, rounded corners, fonts | 1h | ☐ |
-| 13 | Recording UX: waveform animation, countdown timer, status indicators | 1h | ☐ |
-| 14 | Story gallery: cover images (AI-generated or placeholder), card grid | 45m | ☐ |
-| 15 | Loading states: playback status, paused state, TTS progress, and background chunk generation | 30m | ☐ |
-| 16 | Mobile-responsive check (parents use laptops, demo on projector) | 15m | ☐ |
-
-**Checkpoint:** App looks polished and professional. Ready for live demo.
-
-### Afternoon (4h) — Deploy + Demo Prep
-
-| # | Task | Time | Done |
-|---|---|---|---|
-| 17 | Create HF Space (T4 with 4-bit/8-bit loading, or A10G for headroom), push code, verify model downloads | 1h | ☐ |
-| 18 | Confirm no external LLM API secrets are required; set `HF_TOKEN` only if gated models require it | 5m | ☐ |
-| 19 | End-to-end test on live Space (clone → listen → interrupt → ask → resume) | 30m | ☐ |
-| 20 | Fix latency issues: preload weights, cache voice/story audio, cap Q&A tokens, validate pause/resume | 45m | ☐ |
-| 20a | Measure and log all latency targets from mission.md (first chunk, pause, Q&A, resume, replay) | 30m | ☐ |
-| 20b | Validate playback state machine: test all 6 states and legal transitions from tech_stack.md | 30m | ☐ |
-| 21 | Add error handling: graceful failures, loading messages | 30m | ☐ |
-| 22 | Record backup demo video (in case live demo fails) | 30m | ☐ |
-| 23 | Write README.md for the Space (screenshot, description) | 15m | ☐ |
-| 24 | Practice 3-minute demo walkthrough | 30m | ☐ |
-
-**Checkpoint:** Live public URL works. Demo rehearsed.
-
----
-
-## Risk Mitigations
-
-| Risk | Mitigation |
-|---|---|
-| QWEN-TTS-0.6B doesn't clone well | Fall back to longer reference audio (30s+); or use CosyVoice as backup model |
-| GPU OOM with TTS + Whisper + Qwen + Gradio | Use 4-bit/8-bit Qwen loading on T4; prefer A10G for the live demo; load Whisper only on demand; use `whisper-tiny` if needed |
-| HF Space cold start too slow | Use persistent Space (not sleep); preload model in `app.py` global scope |
-| Qwen answer latency too slow | Keep answers to 1–2 sentences; cap story prompt length; cache answers per story/question pair |
-| Story narration feels slow | Stream paragraph chunks; play the first chunk quickly; continue remaining chunks in the background; cache full narration |
-| Interrupt/resume feels brittle | Track playback state, current chunk index, queued generation jobs, and cached next chunks |
-| ASR adds too much delay | Let text questions bypass ASR; use Whisper-tiny/base or browser transcription for demo mode |
-| Live demo fails | Pre-recorded backup video ready |
-
----
-
-## File Structure (Final)
-
-```
-VoiceClone/
-├── app.py                  # Main Gradio app (all logic)
-├── requirements.txt        # Python deps
-├── README.md              # HF Space description
-├── stories/                # 10 cleaned TTS-ready story texts
-│   ├── The_Tale_of_Peter_Rabbit.txt
-│   ├── The_Tale_of_Benjamin_Bunny.txt
-│   ├── The_Tale_of_Jemima_Puddle_Duck.txt
-│   ├── The_Tale_of_Tom_Kitten.txt
-│   ├── The_History_of_Tom_Thumb.txt
-│   ├── The_Story_of_the_Three_Little_Pigs.txt
-│   ├── The_Little_Red_Hen.txt
-│   ├── The_Little_Gingerbread_Man.txt
-│   ├── The_Sleeping_Beauty.txt
-│   └── The_Adventures_of_Puss_in_Boots.txt
-├── 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/
-│   ├── style.css          # Stitch-style custom CSS
-│   ├── script.js          # Animations, waveform
-│   └── favicon.png
-├── assets/
-│   └── covers/            # Story cover images
-├── mission.md             # Product vision (this hackathon)
-├── tech_stack.md          # Technical decisions
-├── sprint.md              # This file
-└── future_mobile_app_considerations.md  # Mobile deployment guidance
-```
-
----
-
-## Key Decisions (Locked)
-
-- **No database** — stateless demo, voice samples held in memory/session
-- **No auth** — open access for hackathon judges
-- **Interruptible chunked streaming** — play paragraph chunks quickly, pause on Ask, answer, then resume from the saved story position
-- **Qwen2.5-3B-Instruct for Q&A** — keeps story comprehension local while improving latency and GPU fit
-- **Short grounded Q&A** — retrieve relevant story passages, cap answers to 1–2 sentences, then synthesize audio
-- **Button-based interruption first** — tap Ask to pause narration; always-listening voice barge-in is out of scope for the hackathon
-- **Single `app.py`** — keep it simple, refactor later
-
----
-
-## Review Notes
-
-| Area | Critique | Upgrade |
-|---|---|---|
-| Model plan | Replacing an external Q&A API with Qwen2.5-3B-Instruct removes API risk while keeping latency practical. | Treat T4 with quantization as viable; use A10G when demo reliability matters more than cost. |
-| Secrets | The old plan required an external LLM API secret, which contradicts the privacy-first positioning. | Remove LLM API secrets from deployment; use only HF credentials when required for model access. |
-| Demo schedule | The original plan left little time for model loading, user-visible wait states, and interruption edge cases. | Add explicit validation around model downloads, quantization, cold-start behavior, chunked playback, pause/resume, and cache hits. |

static/style.css

@@ -1,179 +0,0 @@
-@import url('https://fonts.googleapis.com/css2?family=Inter:wght@400;500;600;700&family=Playfair+Display:ital,wght@0,400;0,600;0,700;1,400&display=swap');
-
-/* ── Base ── */
-body, .gradio-container {
-    background-color: #FAF7F2 !important;
-    font-family: 'Inter', system-ui, sans-serif !important;
-}
-.gradio-container {
-    max-width: 1200px !important;
-    margin: 0 auto !important;
-}
-
-/* ── Typography ── */
-.serif-header {
-    font-family: 'Playfair Display', Georgia, serif !important;
-    color: #1c1c19 !important;
-    font-weight: 700 !important;
-}
-.cream-bg { background-color: #FAF7F2 !important; }
-.highlight-orange { color: #f5841f !important; }
-.highlight-amber  { color: #944a00 !important; }
-
-/* ── Cards ── */
-.card-container {
-    background-color: #f6f3ee !important;
-    border: 1px solid #ebdccb !important;
-    border-radius: 16px !important;
-    padding: 24px !important;
-    box-shadow: 0 2px 8px rgba(148, 74, 0, 0.03) !important;
-}
-.accent-border { border-color: #ddc1b0 !important; }
-
-.dark-card-container {
-    background-color: #122116 !important;
-    color: #FAF7F2 !important;
-    border: 1px solid #1e3422 !important;
-    border-radius: 16px !important;
-    padding: 24px !important;
-    box-shadow: 0 2px 8px rgba(0, 0, 0, 0.15) !important;
-}
-
-/* ── Hero ── */
-.hero-spotlight {
-    background: linear-gradient(135deg, #1e3422 0%, #121f15 100%) !important;
-    color: #FFFFFF !important;
-    border-radius: 24px !important;
-    padding: 32px !important;
-    position: relative;
-    overflow: hidden;
-}
-.badge-featured {
-    background: rgba(245, 132, 31, 0.2);
-    color: #f5841f;
-    border: 1px solid rgba(245, 132, 31, 0.3);
-    border-radius: 9999px;
-    padding: 4px 10px;
-    font-size: 11px;
-    font-weight: 700;
-    text-transform: uppercase;
-    display: inline-block;
-}
-
-/* ── Book grid & cards ── */
-.book-shelf-grid {
-    display: grid;
-    grid-template-columns: repeat(auto-fill, minmax(280px, 1fr));
-    gap: 20px;
-}
-.shelf-card {
-    background: #f6f3ee;
-    border: 1px solid #eadacc;
-    border-radius: 16px;
-    padding: 16px;
-    display: flex;
-    gap: 16px;
-    transition: all 0.3s ease;
-    cursor: pointer;
-}
-.shelf-card:hover {
-    border-color: #f5841f;
-    transform: translateY(-2px);
-    box-shadow: 0 4px 12px rgba(148, 74, 0, 0.06);
-}
-.cover-image {
-    width: 80px;
-    height: 110px;
-    object-fit: cover;
-    border-radius: 8px;
-    box-shadow: 0 2px 6px rgba(0,0,0,0.1);
-}
-
-/* ── Progress bar ── */
-.progress-bar-bg {
-    width: 100%;
-    height: 6px;
-    background: #ebdccb;
-    border-radius: 999px;
-    overflow: hidden;
-}
-.progress-bar-fill {
-    height: 100%;
-    background: #f5841f;
-}
-
-/* ── Recording UX ── */
-@keyframes pulse-ring {
-    0%   { transform: scale(0.85); opacity: 0.6; }
-    50%  { transform: scale(1.15); opacity: 0.25; }
-    100% { transform: scale(1.4);  opacity: 0; }
-}
-@keyframes pulse {
-    0%, 100% { opacity: 1; }
-    50%       { opacity: 0.4; }
-}
-.pulse-circle {
-    position: relative;
-    width: 120px;
-    height: 120px;
-    border-radius: 50%;
-    background: #944a00;
-    color: white;
-    display: flex;
-    flex-direction: column;
-    align-items: center;
-    justify-content: center;
-    margin: 0 auto;
-}
-.pulse-circle::before,
-.pulse-circle::after {
-    content: '';
-    position: absolute;
-    inset: 0;
-    border-radius: 50%;
-    border: 3px solid #944a00;
-    animation: pulse-ring 1.8s ease-out infinite;
-}
-.pulse-circle::after { animation-delay: 0.6s; }
-.recording-active { background: #ef4444 !important; }
-.recording-active::before,
-.recording-active::after { border-color: #ef4444; }
-
-/* ── Subtitle / dialog ticker ── */
-.dialog-synced {
-    background: rgba(0,0,0,0.15);
-    border: 1px solid rgba(255,166,0,0.1);
-    color: #ffd3a6;
-    font-family: 'Playfair Display', Georgia, serif;
-    font-size: 1.25rem;
-    font-style: italic;
-    padding: 24px;
-    border-radius: 16px;
-    text-align: center;
-    min-height: 100px;
-    display: flex;
-    align-items: center;
-    justify-content: center;
-}
-
-/* ── Tabs ── */
-.tabs .tab-nav button {
-    border-bottom: 2px solid transparent !important;
-}
-.tabs .tab-nav button.selected {
-    color: #944a00 !important;
-    border-bottom-color: #944a00 !important;
-    font-weight: 700 !important;
-}
-
-/* ── Mobile responsive ── */
-@media (max-width: 768px) {
-    .gradio-container { max-width: 100% !important; padding: 0 12px !important; }
-    .book-shelf-grid  { grid-template-columns: 1fr !important; }
-    .hero-spotlight   { flex-direction: column !important; padding: 20px !important; }
-    .shelf-card       { flex-direction: column; }
-    .card-container, .dark-card-container { padding: 16px !important; }
-}
-@media (max-width: 480px) {
-    .book-shelf-grid { grid-template-columns: 1fr !important; gap: 12px; }
-}

stories/The_Adventures_of_Puss_in_Boots.txt

@@ -1,88 +0,0 @@
-The Adventures of Puss in Boots
-
-There once liv'd a young man who was very poor.
- For all that he had was a Cat;
- His food being gone, he could get no more,
- And so he resolv'd to kill that.
-
- Now Puss from the cupboard came out and thus spoke,
- "Grieve not my good master, I pray,
- Provide me with boots, and a bag--'tis no joke--
- Your fortune I'll make then straightway."
-
-
- Puss baited his bag with parsley and bread,
- And away to a warren he hied,
- Where he laid himself down as if he was dead,
- Until some young rabbits he spied.
-
- One entered the bag, puss pull'd at the string,
- The rabbit was kill'd in a trice,
- Puss said this fine game I'll take to the king,
- I'm sure he will say it is nice.
-
-
- Next day to a wheat-field Grimalkin repair'd,
- And there two fine partridges caught,
- These he took to the king who kindly enquired,
- From whence the fine present was brought.
-
- "From the Marquis Carabas, great Monarch," said he,
- "These birds and the rabbit I bring,"
- They both were accepted, and puss in high glee
- Receiv'd a reward from the king.
-
-
- This king took a journey, his kingdom to view,
- With his daughter so fine and so gay,
- What happen'd then, I will now tell unto you,
- To my tale therefore listen I pray.
-
- Puss ran to a cornfield, to the reapers he said,
- "When the king comes these words you repeat,
- 'To the Marquis Carabas these fields all belong,
- Or I'll chop you as small as minced meat.'"
-
-
- To an Ogre's grand castle grimalkin now went,
- Which was opened by servants so gay,
- 'Is his highness the Ogre at home sir,' said he,
- 'For my bus'ness is urgent to-day.'
-
- The Ogre received him with kindness, and now,
- Puss entr'd the castle so gay,
- When making a low and reverend bow,
- He march'd to the parlour straightway.
-
-
- 'Tis thought mighty Ogre by all in the nation,
- That miraculous power you possess,
- The power, when you please, of complete transformation,
- This a miracle is and no less.
-
- To convince you 'tis true, the Ogre replied,
- I will change myself now in your sight:
- He did so--a lion he now roars by his side,
- Which put the poor cat in a fright.
-
-
- "Mighty sir," said the Cat, "such a change I must say,
- I never expected to view:
- Yet I venture to doubt--your pardon I pray,
- If a mouse you could change yourself to."
-
- Doubt not, said the Ogre, my power to do so,
- When a mouse he directly became,
- On his victim Grimalkin immediately flew,
- And sealed in an instant his doom.
-
-
- The king and princess now arriv'd at the place,
- But Puss who had travell'd much faster,
- Came out and invited them in with much grace,
- In the name of the Marquis, his master.
-
- In a spacious saloon, they sat themselves down,
- Where a banquet was already spread,
- And that day, "PUSS IN BOOTS" gain'd greater renown,
- For the marquis and princess were wed.

stories/The_History_of_Tom_Thumb.txt

@@ -1,305 +0,0 @@
-The History of Tom Thumb
-
-It is said that in the days of the famed Prince Arthur, who was king of
-Britain, in the year 516, there lived a great magician, called Merlin,
-the most learned and skilful enchanter in the world at that time.
-
-This great magician, who could assume any form he pleased, was
-travelling in the disguise of a poor beggar, and being very much
-fatigued, he stopped at the cottage of an honest ploughman to rest
-himself, and asked for some refreshment.
-
-The countryman gave him a hearty welcome, and his wife, who was a very
-good-hearted, hospital woman, soon brought him some milk in a wooden
-bowl, an some coarse brown bread on a platter.
-
-Merlin was much pleased with this homely repast and the kindness of
-the ploughman and his wife; but he could not help seeing that though
-everything was neat and comfortable in the cottage, they seemed both
-be sad and much cast down. He therefore questioned them on the cause
-of their sadness, and learned they were miserable because they had no
-children.
-
-The poor woman declared, with tears in her eyes, that she should be the
-happiest creature in the world if she had a son; and although he was no
-bigger than her husband's thumb, she would be satisfied.
-
-Merlin was so much amused with the idea of a boy no bigger than a man's
-thumb, that he made up his mind to pay a visit to the queen of the
-fairies, and ask her to grant the poor woman's wish. The droll fancy of
-such a little person among the human race pleased the fairy queen
-too, greatly, and she promised Merlin that the wish should be granted.
-Accordingly, a short time after, the ploughman's wife had a son, who,
-wonderful to relate! was not bigger than his father's thumb.
-
-The fairy queen, wishing to see the little fellow thus born into the
-world, came in at the window while the mother was sitting up in bed
-admiring him. The queen kissed the child, and, giving it the name of Tom
-Thumb, sent for some of the fairies, who dressed her little favorite as
-she bade them.
-
- "An oak-leaf hat he had for his crown;
- His shirt of web by spiders spun;
- With jacket wove of thistle's down;
- His trowsers were of feathers done.
-
- His stockings, of apple-rind they tie
- With eyelash from his mother's eye:
- His shoes were made of mouse's skin
- Tann'd with the downy hair within."
-
-It is remarkable that Tom never grew any larger than his father's thumb,
-which was only of an ordinary size; but as he got older he became very
-cunning and full of tricks. When he was old enough to play with the
-boys, and had lost all his own cherry-stones, he used to creep into
-the bags of his playfellows, fill his pockets, and, getting out unseen,
-would again join in the game.
-
-One day, however, as he was coming out of a bag of cherrystones, where
-he had been pilfering as usual, the boy to whom it belonged chanced to
-see him. "Ah, ha! my little Tommy," said the boy, "so I have caught you
-stealing my cherrystones at last, and you shall be rewarded for your
-thievish tricks." On saying this, he drew the string tight around his
-neck, and gave the bag such a hearty shake, that poor little Tom's legs,
-thighs, and body were sadly bruised. He roared out in pain, and begged
-to be let out, promising never to be guilty of such bad practices again.
-
-A short time afterwards his mother was making a batter-pudding, and Tom
-being very anxious to see how it was made, climbed up to the edge of the
-bowl; but unfortunately his foot slipped and he plumped over head and
-ears into the batter, unseen by his mother, who stirred him into the
-pudding-bag, and put him in the pot to boil.
-
-The batter had filled Tom's mouth, and prevented him from crying; but,
-on feeling the hot water, he kicked and struggled so much in the pot,
-that his mother thought that the pudding was bewitched, and, instantly
-pulling it out of the pot, she threw it to the door. A poor tinker, who
-was passing by, lifted up the pudding, and, putting it into his budget,
-he then walked off. As Tom had now got his mouth cleared of the batter,
-he then began to cry aloud, which so frightened the tinker that he flung
-down the pudding and ran away. The pudding being broke to pieces by the
-fall, Tom crept out covered over with the batter, and with difficulty
-walked home. His mother, who was very sorry to see her darling in such
-a woeful state, put him into a tea-cup, and soon washed off the batter;
-after which she kissed him, and laid him in bed.
-
-Soon after the adventure of the pudding, Tom's mother went to milk her
-cow in the meadow, and she took him along with her. As the wind was very
-high, fearing lest he should be blown away, she tied him to a thistle
-with a piece of fine thread. The cow soon saw the oak-leaf hat, and,
-liking the look of it, took poor Tom and the thistle at one mouthful.
-While the cow was chewing the thistle Tom was afraid of her great teeth,
-which threatened to crush him in pieces, and he roared out as loud as he
-could:
-
-"Mother, mother!"
-
-"Where are you, Tommy, my dear Tommy?" said his mother.
-
-"Here, mother," replied he, "in the red cow's mouth."
-
-His mother began to cry and wring her hands; but the cow, surprised
-at the odd noise in her throat, opened her mouth and let Tom drop out.
-Fortunately his mother caught him in her apron as he was falling to the
-ground, or he would have been dreadfully hurt. She then put Tom in her
-bosom and ran home with him.
-
-Tom's father made him a whip of barley straw to drive the cattle with,
-and having one day gone into the fields, he slipped a foot and rolled
-into the furrow. A raven, which was flying over, picked him up and flew
-with him to the top of a giant's castle that was near the seaside, and
-there left him.
-
-Tom was in a dreadful state, and did not know what to do; but he was
-soon more dreadfully frightened; for old Grumbo, the giant, came up to
-walk on the terrace, and seeing Tom, he took him up and swallowed him
-like a pill.
-
-The giant had no sooner swallowed Tom than he began to repent what he
-had done; for Tom began to kick and jump about so much that he felt very
-uncomfortable, and at last threw him up again into the sea. A large
-fish swallowed Tom the moment he fell into the sea, which was soon after
-caught, and bought for the table of King Arthur. When they opened the
-fish in order to cook it, every on was astonished at finding such a
-little boy, and Tom was quite delighted to be out again. They carried
-him to the king, who made Tom his dwarf, and he soon grew a great
-favorite at court: for by his tricks and gambols he not only amused the
-king and queen, but also all the knights of the Round Table.
-
-It is said that when the kind rode out on horseback he often took
-Tom along with him, and if a shower came on he used to creep into his
-majesty's waistcoat pocket, where he slept till the rain was over.
-
-King Arthur one day asked Tom about his parents, wishing to know if they
-were as small as he was, and whether rich or poor. Tom told the king
-that his father and mother were as tall as any of the persons about
-the court, but rather poor. On hearing this the king carried Tom to the
-treasure, the place where he kept all his money, and told him to take
-as much money as he could carry home to his parents, which made the poor
-little fellow caper with joy. Tom went immediately to fetch a purse,
-which was made of a water-bubble, and then returned to the treasury,
-where he got a silver three-penny-piece to put into it.
-
-Our little hero had some trouble in lifting the burden upon his back;
-but he at last succeeded in getting it placed to his mind, and set
-forward on his journey. However, without meeting with any accidents, and
-after resting himself more than a hundred times by the way, in two days
-and two nights he reached his father's house in safety.
-
-Tom had travelled forty-eight hours with a huge silver-piece on his
-back, and was almost tired to death, when his mother ran out to meet
-him, and carried him into the house.
-
-Tom's parents were both happy to see him, and the more so as he had
-brought such an amazing sum of money with him; but the poor little
-fellow was excessively wearied, having travelled half a mile in
-forty-eight hours, with a huge silver three-penny-piece on his back.
-His mother, in order to recover him, placed him in a walnut shell by the
-fireside, and feasted him for three days on a hazel nut, which made him
-very sick; for a whole nut used to serve him a month.
-
-Tom was soon well again; but as there had been a fall of rain, and the
-ground was very wet, he could not travel back to King Arthur's court;
-therefore his mother, one day when the wind was blowing in that
-direction, made a little parasol of cambric paper, and tying Tom to it,
-she gave him a puff into the air with her mouth, which soon carried him
-to the king's palace.
-
-Just at the time when Tom came flying across the courtyard, the cook
-happened to be passing with the king's great bowl of furmenty, which was
-a dish his majesty was very fond of; but unfortunately the poor little
-fellow fell plump into the middle of it, and splashed the hot furmenty
-about the cook's face.
-
-The cook, who was an ill-natured fellow, being in a terrible rage at Tom
-for frightening and scalding him with the furmenty, went straight to the
-king, and said that Tom had jumped into the royal furmenty, and thrown
-it down out of mere mischief. The king was so enraged when he heard
-this, that he ordered Tom to be seized and tried for high treason; and
-there being no person who dared to plead for him, he was condemned to be
-beheaded immediately.
-
-On hearing this dreadful sentence pronounced, poor Tom fell a-trembling
-with fear, but, seeing no means of escape, and observing a miller close
-to him gaping with his great mouth, as country boobies do at a far, he
-took a leap, and fairly jumped down his throat. This exploit was done
-with such activity that not one person present saw it, and even the
-miller did not know the trick which Tom had played upon him. Now, as
-Tom had disappeared, the court broke up, and the miller went home to his
-mill.
-
-When Tom heard the mill at work he knew he was clear of the court, and
-therefore he began to tumble and roll about, so that the poor miller
-could get no rest, thinking he was bewitched; so he sent for a doctor.
-When the doctor came, Tom began to dance and sing; and the doctor, being
-as much frightened as the miller, sent in haste for five other doctors
-and twenty learned men.
-
-When they were debating about this extraordinary case, the miller
-happened to yawn, when Tom, seizing the chance, made another jump, and
-alighted safely upon his feet in the middle of the table.
-
-The miller, who was very much provoked at being tormented by such a
-little pygmy creature, fell into a terrible rage, and, laying hold of
-Tom, ran to the king with him; but his majesty, being engaged with state
-affairs, ordered him to be taken away and kept in custody till he sent
-for him.
-
-The cook was determined that Tom should not slip out of his hands this
-time, so he put him into a mouse-trap, and left him to peep through the
-wires. Tom had remained in the trap a whole week, when he was sent for
-by King Arthur, who pardoned him for throwing down the furmenty,
-and took him again into favor. On account of his wonderful feats of
-activity, Tom was knighted by the king, and went under the name of the
-renowned Sir Thomas Thumb. As Tom's clothes had suffered much in the
-batter-pudding, the furmenty, and the insides of the giant, miller, and
-fishes, his majesty ordered him a new suit of clothes, and to be mounted
-as a knight.
-
- "Of Butterfly's wings his shirt was made,
- His boots of chicken's hide;
- And by a nimble fairy blade,
- Well learned in the tailoring trade,
-
- His clothing was supplied.--
- A needle dangled by his side;
- A dapper mouse he used to ride,
- Thus strutted Tom in stately pride!"
-
- It was certainly very diverting to see Tom in this dress, and
-mounted on the mouse, as he rode out a-hunting with the king and
-nobility, who were all ready to expire with laughter at Tom and his fine
-prancing charger.
-
-One day, as they were riding by a farmhouse, a large cat, which was
-lurking about the door, made a spring, and seized both Tom and his
-mouse. She then ran up a tree with them, and was beginning to devour the
-mouse; but Tom boldly drew his sword, and attacked the cat so fiercely
-that she let them both fall, when one of the nobles caught him in his
-hat, and laid him on a bed of down, in a little ivory cabinet.
-
-The queen of fairies came soon after to pay Tom a visit, and carried him
-back to Fairy-land, where he lived several years. During his residence
-there, King Arthur, and all the persons who knew Tom, had died; and as
-he was desirous of being again at court, the fairy queen, after dressing
-him in a suit of clothes, sent him flying through the air to the palace,
-in the days of king Thunstone, the successor of Arthur. Every one
-flocked round to see him, and being carried to the king, he was asked
-who he was--whence he came--and where he lived? Tom answered:
-
- "My name is Tom Thumb,
- From the fairies I've come.
- When King Arthur shone,
- His court was my home.
- In me he delighted,
- By him I was knighted;
- Did you never hear of Sir Thomas Thumb?"
-
-The king was so charmed with this address that he ordered a little
-chair to be made, in order that Tom might sit upon his table, and also
-a palace of gold, a span high, with a door an inch wide, to live in. He
-also gave him a coach, drawn by six small mice.
-
-The queen was so enraged at the honor paid to Sir Thomas that she
-resolved to ruin him, and told the king that the little knight had been
-saucy to her.
-
-The king sent for Tom in great haste, but being fully aware of the
-danger of royal anger, he crept into an empty snail-shell, where he lay
-for a long time, until he was almost starved with hunger; but at last he
-ventured to peep out, and seeing a fine large butterfly on the ground,
-near his hiding-place, he approached very cautiously, and getting
-himself placed astride on it, was immediately carried up into the air.
-The butterfly flew with him from tree to tree and from field to field,
-and at last returned to the court, where the king and nobility all
-strove to catch him; but at last poor Tom fell from his seat into a
-watering-pot, in which he was almost drowned.
-
-When the queen saw him she was in a rage, and said he should be
-beheaded; and he was again put into a mouse-trap until the time of his
-execution.
-
-However, a cat, observing something alive in the trap, patted it about
-till the wires broke, and set Thomas at liberty.
-
-The king received Tom again into favor, which he did not live to enjoy,
-for a large spider one day attacked him; and although he drew his sword
-and fought well, yet the spider's poisonous breath at last overcame him;
-
- "He fell dead on the ground where he stood,
- and the spider suck'd every drop of his blood."
-
-King Thunstone and his whole court were so sorry at the loss of their
-little favorite, that they went into mourning, and raised a fine white
-marble monument over his grave, with the following epitaph:
-
- "Here lyes Tom Thumb, King Arthur's knight,
- Who died by a spider's cruel bite.
- He was well known in Arthur's court,
- Where he afforded gallant sport;
- He rode at tilt and tournament,
- And on a mouse a-hunting went.
- Alive he filled the court with mirth;
- His death to sorrow soon gave birth.
- Wipe, wipe your eyes, and shake your head,
- And cry,--Alas! Tom Thumb is dead!"

stories/The_Little_Gingerbread_Man.txt

@@ -1,211 +0,0 @@
-The Little Gingerbread Man
-
-One day, the cook went into the kitchen to make some gingerbread.
-She took some flour and water, and treacle and ginger, and mixed
-them all well together, and she put in some more water to make it
-thin, and then some more flour to make it thick, and a little salt
-and some spice, and then she rolled it out into a beautiful,
-smooth, dark-yellow dough.
-
-Then she took the square tins and cut out some square cakes for the
-little boys, and with some round tins she cut out some round cakes
-for the little girls, and then she said, "I'm going to make a
-little gingerbread man for little Bobby." So she took a nice round
-lump of dough for his body, and a smaller lump for his head, which
-she pulled out a little for the neck. Two other lumps were stuck on
-beneath for the legs, and were pulled out into proper shape, with
-feet and toes all complete, and two still smaller pieces were made
-into arms, with dear little hands and fingers.
-
-
-But the nicest work was done on the head, for the top was frizzed
-up into a pretty sugary hat; on either side was made a dear little
-ear, and in front, after the nose had been carefully moulded, a
-beautiful mouth was made out of a big raisin, and two bright little
-eyes with burnt almonds and caraway seeds.
-
-Then the gingerbread man was finished ready for baking, and a very
-jolly little man he was. In fact, he looked so sly that the cook
-was afraid he was plotting some mischief, and when the batter was
-ready for the oven, she put in the square cakes and she put in the
-round cakes; and then she put in the little gingerbread man in a
-far back corner, where he couldn't get away in a hurry.
-
-
-Then she went up to sweep the parlor, and she swept and she swept
-till the clock struck twelve, when she dropped her broom in a
-hurry, and exclaiming, "Lawks! the gingerbread will be all baked to
-a cinder," she ran down into the kitchen, and threw open the oven
-door. And the square cakes were all done, nice and hard and brown,
-and the round cakes were all done, nice and hard and brown, and the
-gingerbread man was all done too, nice and hard and brown; and he
-was standing up in his corner, with his little caraway-seed eyes
-sparkling, and his raisin mouth bubbling over with mischief, while
-he waited for the oven door to be opened. The instant the door was
-opened, with a hop, skip, and a jump, he went right over the square
-cakes and the round cakes, and over the cook's arm, and before she
-could say "Jack Robinson" he was running across the kitchen floor,
-as fast as his little legs would carry him, towards the back door,
-which was standing wide open, and through which he could see the
-garden path.
-
-
-The old cook turned round as fast as she could, which wasn't very
-fast, for she was rather a heavy woman and she had been quite taken
-by surprise, and she saw lying right across the door-way, fast
-asleep in the sun, old Mouser, the cat.
-
-
-"Mouser, Mouser," she cried, "stop the gingerbread man! I want him
-for little Bobby." When the cook first called, Mouser thought it
-was only some one calling in her dreams, and simply rolled over
-lazily; and the cook called again, "Mouser, Mouser!" The old cat
-sprang up with a jump, but just as she turned round to ask the cook
-what all the noise was about, the little gingerbread man cleverly
-jumped under her tail, and in an instant was trotting down the
-garden walk. Mouser turned in a hurry and ran after, although she
-was still rather too sleepy to know what it was she was trying to
-catch, and after the cat came the cook, lumbering along rather
-heavily, but also making pretty good speed.
-
-
-Now at the bottom of the walk, lying fast asleep in the sun against
-the warm stones of the garden wall, was Towser, the dog.
-
-And the cook called out: "Towser, Towser, stop the gingerbread man!
-I want him for little Bobby."
-
-And when Towser first heard her calling he thought it was some one
-speaking in his dreams, and he only turned over on his side, with
-another snore, and then the cook called again, "Towser, Towser,
-stop him, stop him!"
-
-Then the dog woke up in good earnest, and jumped up on his feet to
-see what it was that he should stop. But just as the dog jumped up,
-the little gingerbread man, who had been watching for the chance,
-quietly slipped between his legs, and climbed up on the top of the
-stone wall, so that Towser saw nothing but the cat running towards
-him down the walk, and behind the cat the cook, now quite out of
-breath.
-
-
-He thought at once that the cat must have stolen something, and
-that it was the cat the cook wanted him to stop. Now, if there was
-anything that Towser liked, it was going after the cat, and he
-jumped up the walk so fiercely that the poor cat did not have time
-to stop herself or to get out of his way, and they came together
-with a great fizzing, and barking, and meowing, and howling, and
-scratching, and biting, as if a couple of Catherine-wheels had gone
-off in the wrong way and had got mixed up with one another.
-
-
-But the old cook had been running so hard that she was not able to
-stop herself any better than the cat had done, and she fell right
-on top of the mixed up dog and cat, so that all three rolled over
-on the walk in a heap together.
-
-And the cat scratched whichever came nearest, whether it was a
-piece of the dog or of the cook, and the dog bit at whatever came
-nearest, whether it was a piece of the cat or of the cook, so that
-the poor cook was badly pummelled on both sides.
-
-
-Meanwhile, the gingerbread man had climbed up on the garden wall,
-and stood on the top with his hands in his pockets, looking at the
-scrimmage, and laughing till the tears ran down from his little
-caraway-seed eyes and his raisin mouth was bubbling all over with
-fun.
-
-
-After a little while, the cat managed to pull herself out
-from under the cook and the dog, and a very cast-down and
-crumpled-up-looking cat she was. She had had enough of hunting
-gingerbread men, and she crept back to the kitchen to repair
-damages.
-
-
-The dog, who was very cross because his face had been badly
-scratched, let go of the cook, and at last, catching sight of the
-gingerbread man, made a bolt for the garden wall. The cook picked
-herself up, and although her face was also badly scratched and her
-dress was torn, she was determined to see the end of the chase, and
-she followed after the dog, though this time more slowly.
-
-
-When the gingerbread man saw the dog coming, he jumped down on the
-farther side of the wall, and began running across the field. Now
-in the middle of the field was a tree, and at the foot of the tree
-was lying Jocko, the monkey. He wasn't asleep--monkeys never
-are--and when he saw the little man running across the field and
-heard the cook calling, "Jocko, Jocko, stop the gingerbread man,"
-he at once gave one big jump. But he jumped so fast and so far that
-he went right over the gingerbread man, and as luck would have it,
-he came down on the back of Towser, the dog, who had just scrambled
-over the wall, and whom he had not before noticed. Towser was
-naturally taken by surprise, but he turned his head around and
-promptly bit off the end of the monkey's tail, and Jocko quickly
-jumped off again, chattering his indignation.
-
-
-Meanwhile, the gingerbread man had got to the bottom of the tree,
-and was saying to himself: "Now, I know the dog can't climb a tree,
-and I don't believe the old cook can climb a tree; and as for the
-monkey I'm not sure, for I've never seen a monkey before, but I am
-going up."
-
-So he pulled himself up hand over hand until he had got to the
-topmost branch.
-
-But the monkey had jumped with one spring onto the lowest branch,
-and in an instant he also was at the top of the tree.
-
-The gingerbread man crawled out to the furthermost end of the
-branch, and hung by one hand, but the monkey swung himself under
-the branch, and stretching out his long arm, he pulled the
-gingerbread man in. Then he held him up and looked at him so
-hungrily that the little raisin mouth began to pucker down at the
-corners, and the caraway-seed eyes filled with tears.
-
-
-And then what do you think happened? Why, little Bobby himself came
-running up. He had been taking his noon-day nap upstairs, and in
-his dreams it seemed as if he kept hearing people call "Little
-Bobby, little Bobby!" until finally he jumped up with a start, and
-was so sure that some one was calling him that he ran down-stairs,
-without even waiting to put on his shoes.
-
-
-As he came down, he could see through the window in the field
-beyond the garden the cook, and the dog, and the monkey, and could
-even hear the barking of Towser and the chattering of Jocko. He
-scampered down the walk, with his little bare feet pattering
-against the warm gravel, climbed over the wall, and in a few
-seconds arrived under the tree, just as Jocko was holding up the
-poor little gingerbread man.
-
-
-"Drop it, Jocko!" cried Bobby, and drop it Jocko did, for he always
-had to mind Bobby. He dropped it so straight that the gingerbread
-man fell right into Bobby's uplifted pinafore.
-
-Then Bobby held him up and looked at him, and the little raisin
-mouth puckered down lower than ever, and the tears ran right out of
-the caraway-seed eyes.
-
-But Bobby was too hungry to mind gingerbread tears, and he gave one
-big bite, and swallowed down both legs and a piece of the body.
-
-
-"OH!" said the gingerbread man, "I'M ONE-THIRD GONE!"
-
-Bobby gave a second bite, and swallowed the rest of the body and
-the arms.
-
-
-"OH!" said the gingerbread man, "I'M TWO-THIRDS GONE!"
-
-Bobby gave a third bite, and gulped down the head.
-
-"Oh!" said the gingerbread man, "I'm all gone!"
-
-And so he was--and that is the end of the story.

stories/The_Little_Red_Hen.txt

@@ -1,216 +0,0 @@
-The Little Red Hen
-
-A Little Red Hen lived in a barnyard. She spent almost all of her time
-walking about the barnyard in her picketty-pecketty fashion,
-scratching everywhere for worms.
-
-
-She dearly loved fat, delicious worms and felt they were absolutely
-necessary to the health of her children. As often as she found a worm
-she would call "Chuck-chuck-chuck!" to her chickies.
-
-
-When they were gathered about her, she would distribute choice morsels
-of her tid-bit. A busy little body was she!
-
-
-A cat usually napped lazily in the barn door, not even bothering
-herself to scare the rat who ran here and there as he pleased. And as
-for the pig who lived in the sty--he did not care what happened so
-long as he could eat and grow fat.
-
-
-One day the Little Red Hen found a Seed. It was a Wheat Seed, but the
-Little Red Hen was so accustomed to bugs and worms that she supposed
-this to be some new and perhaps very delicious kind of meat. She bit
-it gently and found that it resembled a worm in no way whatsoever as
-to taste although because it was long and slender, a Little Red Hen
-might easily be fooled by its appearance.
-
-
-Carrying it about, she made many inquiries as to what it might be. She
-found it was a Wheat Seed and that, if planted, it would grow up and
-when ripe it could be made into flour and then into bread.
-
-
-When she discovered that, she knew it ought to be planted. She was so
-busy hunting food for herself and her family that, naturally, she
-thought she ought not to take time to plant it.
-
-
-So she thought of the Pig--upon whom time must hang heavily and of the
-Cat who had nothing to do, and of the great fat Rat with his idle
-hours, and she called loudly:
-
-
-"Who will plant the Seed?"
-
-
-But the Pig said, "Not I," and the Cat said, "Not I," and the Rat
-said, "Not I."
-
-
-"Well, then," said the Little Red Hen, "I will."
-
-And she did.
-
-
-Then she went on with her daily duties through the long summer days,
-scratching for worms and feeding her chicks, while the Pig grew fat,
-and the Cat grew fat, and the Rat grew fat, and the Wheat grew tall
-and ready for harvest.
-
-
-So one day the Little Red Hen chanced to notice how large the Wheat
-was and that the grain was ripe, so she ran about calling briskly:
-"Who will cut the Wheat?"
-
-The Pig said, "Not I," the Cat said, "Not I," and the Rat said, "Not
-I."
-
-
-"Well, then," said the Little Red Hen, "I will."
-
-And she did.
-
-
-She got the sickle from among the farmer's tools in the barn and
-proceeded to cut off all of the big plant of Wheat.
-
-On the ground lay the nicely cut Wheat, ready to be gathered and
-threshed, but the newest and yellowest and downiest of Mrs. Hen's
-chicks set up a "peep-peep-peeping" in their most vigorous fashion,
-proclaiming to the world at large, but most particularly to their
-mother, that she was neglecting them.
-
-
-Poor Little Red Hen! She felt quite bewildered and hardly knew where
-to turn.
-
-Her attention was sorely divided between her duty to her children and
-her duty to the Wheat, for which she felt responsible.
-
-So, again, in a very hopeful tone, she called out, "Who will thresh
-the Wheat?"
-
-But the Pig, with a grunt, said, "Not I,"
-and the Cat, with a meow, said, "Not I," and
-the Rat, with a squeak, said, "Not I."
-
-So the Little Red Hen, looking, it must be admitted, rather
-discouraged, said, "Well, I will, then."
-
-And she did.
-
-Of course, she had to feed her babies first, though, and when she had
-gotten them all to sleep for their afternoon nap, she went out and
-threshed the Wheat. Then she called out: "Who will carry the Wheat to
-the mill to be ground?"
-
-
-Turning their backs with snippy glee,
-that Pig said, "Not I,"
-
-
-and that Cat said, "Not I," and that Rat said, "Not I."
-
-
-So the good Little Red Hen could do nothing but say, "I will then."
-And she did.
-
-Carrying the sack of Wheat, she trudged off to the distant mill. There
-she ordered the Wheat ground into beautiful white flour. When the
-miller brought her the flour she walked slowly back all the way to her
-own barnyard in her own picketty-pecketty fashion.
-
-
-She even managed, in spite of her load, to catch a nice juicy worm now
-and then and had one left for the babies when she reached them. Those
-cunning little fluff-balls were so glad to see their mother. For the
-first time, they really appreciated her.
-
-
-After this really strenuous day Mrs. Hen retired to her slumbers
-earlier than usual--indeed, before the colors came into the sky to
-herald the setting of the sun, her usual bedtime hour.
-
-She would have liked to sleep late in the morning, but her chicks,
-joining in the morning chorus of the hen yard, drove away all hopes of
-such a luxury.
-
-Even as she sleepily half opened one eye, the thought came to her that
-to-day that Wheat must, somehow, be made into bread.
-
-
-She was not in the habit of making bread, although, of course, anyone
-can make it if he or she follows the recipe with care, and she knew
-perfectly well that she could do it if necessary.
-
-So after her children were fed and made sweet and fresh for the day,
-she hunted up the Pig, the Cat and the Rat.
-
-
-Still confident that they would surely help her some day she sang out,
-"Who will make the bread?"
-
-
-Alas for the Little Red Hen! Once more her hopes were dashed! For the
-Pig said, "Not I,"
-
-
-the Cat said, "Not I," and the Rat said, "Not I."
-
-
-So the Little Red Hen said once more, "I will then," and she did.
-
-Feeling that she might have known all the time that she would have to
-do it all herself, she went and put on a fresh apron and spotless
-cook's cap. First of all she set the dough, as was proper. When it was
-time she brought out the moulding board and the baking tins, moulded
-the bread, divided it into loaves, and put them into the oven to bake.
-All the while the Cat sat lazily by, giggling and chuckling.
-
-
-And close at hand the vain Rat powdered his nose and admired himself
-in a mirror.
-
-
-In the distance could be heard the long-drawn snores of the dozing
-Pig.
-
-
-At last the great moment arrived. A delicious odor was wafted upon the
-autumn breeze. Everywhere the barnyard citizens sniffed the air with
-delight.
-
-
-The Red Hen ambled in her picketty-pecketty way toward the source of
-all this excitement.
-
-
-Although she appeared to be perfectly calm, in reality she could only
-with difficulty restrain an impulse to dance and sing, for had she not
-done all the work on this wonderful bread?
-
-
-Small wonder that she was the most excited person in the barnyard!
-
-She did not know whether the bread would be fit to eat, but--joy of
-joys!--when the lovely brown loaves came out of the oven, they were
-done to perfection.
-
-
-Then, probably because she had acquired the habit, the Red Hen called:
-"Who will eat the Bread?"
-
-
-All the animals in the barnyard were watching hungrily and smacking
-their lips in anticipation, and the Pig said, "I will," the Cat said,
-"I will," the Rat said, "I will."
-
-But the Little Red Hen said,
-
-
-"No, you won't. I will."
-
-And she did.

stories/The_Sleeping_Beauty.txt

@@ -1,362 +0,0 @@
-The Sleeping Beauty Picture Book
-
-Long, long ago, in ancient times, there lived a King and Queen,
-And for the blessing of a child their longing sore had been:
-At last, a little daughter fair, to their great joy, was given,
-And to the christening feast they made, they bade the Fairies seven--
-
-
-The Fairies seven, who loved the land--that they the child
- might bless.
-Yet one old Fairy they left out, in pure forgetfulness.
-And at the feast, the dishes fair were of the reddest gold;
-But when the Fairy came, not one for her, so bad and old,
-Angry was she, because her place and dish had been forgot,
-And angry things she muttered long, and kept her anger hot.
-
-
-Until the Fairy godmothers their gifts and wishes gave:
-She waited long to spoil the gifts, and her revenge to have.
-One gave the Princess goodness, and one gave her beauty rare;
-One gave her sweetest singing voice; one, gracious mien and air;
-One, skill in dancing; one, all cleverness; and then the crone
-Came forth, and muttered, angry still, and good gift gave she none;
-
-
-But said, that in the future years the Princess young should die,
-By pricking of a spindle-point--ah, woeful prophecy!
-But now, a kind young Fairy, who had waited to the last,
-Stepped forth, and said, "No, she shall sleep till a hundred years
- are past;
-And then she shall be wakened by a King's son--truth I tell--
-And he will take her for his wife, and all will yet be well."
-
-In vain in all her father's Court the spinning-wheel's forbid
-In vain in all the country-side the spindles sharp are hid;
-For in a lonely turret high, and up a winding stair,
-There lives an ancient woman who still turns her wheel with care.
-The Princess found her out one day, and tried to learn to spin;
-Alas! the spindle pricked her hand--the charm had entered in!
-
-And down she falls in death-like sleep: they lay her on her bed,
-And all around her sink to rest--a palace of the dead!
-A hundred years pass--still they sleep, and all around the place
-A wood of thorns has risen up--no path a man can trace.
-At last, a King's son, in the hunt, asked how long it had stood,
-And what old towers were those he saw above the ancient wood.
-
-
-An aged peasant told of an enchanted palace, where
-A sleeping King and Court lay hid, and sleeping Princess fair.
-Through the thick wood, that gave him way, and past the thorns that drew
-Their sharpest points another way, the King's son presses through.
-He reached the guard, the court, the hall,--and there, where'er he
- stept,
-He saw the sentinels, and grooms, and courtiers as they slept.
-
-
-Ladies in act to smile, and pages in attendance wait;
-The horses slept within their stalls, the dogs about the gate.
-The King's son presses on, into an inner chamber fair,
-And sees, laid on a silken bed, a lovely lady there;
-So sweet a face, so fair--was never beauty such as this;
-He stands--he stoops to gaze--he kneels--he wakes her with a kiss.
-
-
-He leads her forth: the magic sleep of all the Court is o'er,--
-They wake, they move, they talk, they laugh, just as they did of yore
-A hundred years ago. The King and Queen awake, and tell
-How all has happed, rejoicing much that all has ended well.
-They hold the wedding that same day, with mirth and feasting good--
-The wedding of the Prince and Sleeping Beauty in the Wood.
-
-
-Aa
-
-
-As I was going up Pippin Hill
- Pippin hill was dirty.
-There I met a pretty miss,
- And she dropped me a curtsy.
-
-Bb
-
-
-Boys and girls come out to play.
-The moon doth shine as bright as day:
-Come with a whoop, come with a call,
-Come with a good will, or not at all.
-
-Cc
-
-
-Cuckoo, cherry tree
-Come down & tell me
-How many years
-I have to live!
-
-Dd
-
-
-Ding, dong, bell,
-Pussy's in the well.
-Who put her in?
-Naughty Johnny Green.
-Who pulled her out?
-Little Tommy Trout.
-
-Ee
-
-
-Early to bed, and early to rise,
-Is the way to be healthy, wealthy, and wise.
-
-Ff
-
-
-For every evil under the sun
- There is a remedy, or there is none.
-If there be one, try and find it;
- If there be none, never mind it.
-
-Gg
-
-
-Great A, little A; Bouncing B;
-The cat's in the cupboard.
-And she can't see me.
-
-Hh
-
-
-Hark! hark! the dogs do bark,
-The Beggars are coming to town.
-Some in rags & some in jag's
-And some in velvet gowns.
-
-Ii
-
-
-I had a little pony
-They called it Dapple Gray,
-I lent it to a lady
-To ride a mile away.
-She whipped it, she slashed it,
-She drove it through the mire.
-I will not lend my pony more,
-For all the ladies' hire.
-
-Jj
-
-
-John Smith, fellow fine,
-Can you shoe this horse o' mine?
-Yes, indeed, and that I can
-As well as any man!
-There's a nail upon the tae, &c
-To make the powny speel the brae;
-There's a nail and there's a brod
- --a horse weel shod.
-
-Kk
-
-
-King o' Katchem met a king
-In a narrow lane;
-Says this king to that king
-"Where have you been?"
-
-Oh, I've been a hunting
-With my dog & my doe
-Pray lend him to me,
-That I may do so.
-
-"There's the dog, TAKE the dog."
-"What's the dog's name?"
-"I've told you already."
-"Pray tell me again."
-
-Ll
-
-
-Ladybird, ladybird, fly away home,
-Your house is a-fire, your children all gone,
-All but one that lies under a stone;
-Fly the home, ladybird, ere it be gone!
-
-Mm
-
-
-Multiplication is vexation,
-Division is twice as bad;
-The Rule of Three it puzzles me
-And Fractions drive me mad!
-
-Nn
-
-
-Nievie, nievie, nicknack,
-Which hand will ye tak'?
-Tak' the right, or tak' the wrong,
-I'll beguile ye, if I can.
-
-Oo
-
-
-Oh, Mother, I'm to be married
-To Mr. Punchinello,
-To Mr. Pun,
-To Mr. Chin,
-To Mr. Nel,
-To Mr. Lo,
-Mr. Pun, Mr. Chin, Mr. Nel, Mr. Lo
-To Mr. Punchinello.
-
-Pp
-
-
-Pat a cake, pat a cake, baker's man,
-Prick it and bake it as fast as you can.
-Prick it, and bake it, and mark it with B,
-And put it in the oven for baby and me.
-
-Qq
-
-
-Queen of Hearts,
-She made some tarts,
-All on a summer's day.
-The Knave of Hearts,
-He stole the tarts,
-And took them all away.
-
-Rr
-
-
-Rain, rain,
-Go to Spain,
-And never come back again.
-
-Ss
-
-
-See, Saw, Margery Daw,
-Sold her bed, and lay upon straw.
-
-Tt
-
-
-Three children sliding on the ice,
-Upon a summer's day;
-As it fell out they all fell in:
-The rest they ran away.
-
-Uu
-
-
-Uphill spare me,
-Downhill 'ware me,
-On level ground spare me not,
-And in the stable forget me not.
-
-Vv
-
-
-VALENTINE
-
-The rose is red; the Violet's blue
-The pink is sweet; & so are you.
-
-Ww
-
-
-"We'll go a-shooting," says Robin to Bobbin;
-"We'll go a-shooting," says Richard to John.
-"We'll go a-shooting," says John all alone;
-"We'll go a-shooting," says every one.
-
-Xx
-
-
-XMAS GIFTS.
-
-The first day of Xmas
-My mother sent to me
-A partridge in a pear tree.
-
-Yy
-
-
-YULE DAYS.
-
-The king sent his lady on the first Yule day,
-A papingo-aye
-Who learns my carol & carries it away?
-
-Zz
-
-
-ZOOLOGICAL GARDENS.
-
-Where you shall go, too;
-But it's through A B C that we get to the Zoo.
-
-
-BLUEBEARD.
-
-
-Once on a time there lived a man hated by all he knew,
-Both that his ways were very bad, and that his beard was blue;
-But as he was so rich and grand, and led a merry life,
-A lady he contrived at last to induce to be his wife.
-
-
-For a month after the wedding they lived and had good cheer,
-And then said Bluebeard to his wife, "I'll say good-bye, my dear;
-Indeed, it is but for six weeks that I shall be away,
-I beg that you'll invite your friends, and feast and dance and play;
-And all my property I'll leave confided to your care.
-Here are the keys of all my chests, there's plenty and to spare."
-
-"But this small key belongs to one small room on the ground-floor,--
-And this you must not open, or you will repent it sore."
-And so he went; and all the friends came there from far and wide,
-And in her wealth the lady took much happiness and pride;
-But in a while this kind of joy grew nearly satisfied.
-
-
-And oft she saw the closet door, and longed to look inside.
-At last she could no more refrain, and turned the little key,
-And looked within, and fainted straight the horrid sight to see;
-For there upon the floor was blood, and on the walls were wives,
-For Bluebeard first had married them, then cut their throats
- with knives.
-
-And this poor wife, distracted, picked the key up from the floor,
-All stained with blood; and with much fear she shut and locked the door.
-She tried in vain to clean the key and wash the stain away
-With sand and soap,--it was no use. Bluebeard came back that day;
-At once he asked her for the key,--he saw the bloody stain.--
-
-
-"You have been in the closet once, and you shall go again!"
-"O spare me, spare me! give me time, nor kill me hastily!"
-"You have a quarter of an hour,--then, madam, you must die!"
-"O sister Anne, go up, go up, and look out from the tower;"
-"I'm dead unless my brothers come in a quarter of an hour!"
-And Anne looked once, and Anne looked twice, and nothing saw abroad,
-But shining sun and growing grass, and dust upon the road.
-
-
-"Come down!" cried Bluebeard, "time is up!" With many a sigh and moan,
-She prayed him for a minute more; he shouted still, "Come down!"
-"O sister Anne, look out, look out! and do you nothing see?"
-"At last I see our brothers two come riding hastily."
-"Now spare me, Bluebeard,--spare thy wife!" but as the words were said,
-
-
-And just as Bluebeard's cruel blade was descending on her head,
-In rushed the brothers with their swords,--they cut the murderer down,
-And saved their sister's life, and gained much glory and renown;
-And then they all with gold and plate and jewels rare made free,
-And ever after lived content on Bluebeard's property.

stories/The_Story_of_the_Three_Little_Pigs.txt

@@ -1,129 +0,0 @@
-The Story of the Three Little Pigs
-
-Once upon a time there was an old Sow with three little Pigs,
-and as she had not enough to keep them, she sent them out to seek their
-fortune.
-
-
-The first that went off met a Man with a bundle of straw, and said to
-him, "Please, Man, give me that straw to build me a house"; which the
-Man did, and the little Pig built a house with it. Presently came along
-a Wolf, and knocked at the door, and said, "Little Pig, little Pig, let
-me come in."
-
-To which the Pig answered, "No, no, by the hair of my chinny chin chin."
-
-
-"Then I'll huff and I'll puff, and I'll blow your house
-in!" said the Wolf. So he huffed and he puffed, and he blew his house
-in, and ate up the little Pig.
-
-The second Pig met a Man with a bundle of furze, and said, "Please, Man,
-give me that furze to build a house"; which the Man did, and the Pig
-built his house.
-
-
-Then along came the Wolf and said, "Little Pig, little Pig, let me come
-in."
-
-"No, no, by the hair of my chinny chin chin."
-
-"Then I'll puff and I'll huff, and I'll blow your house in!" So he
-huffed and he puffed, and he puffed and he huffed, and at last he blew
-the house down, and ate up the second little Pig.
-
-
-The third little Pig met a Man with a load of bricks, and said, "Please,
-Man, give me those bricks to build a house with"; so the Man gave him
-the bricks, and he built his house with them. So the Wolf came, as he
-did to the other little Pigs, and said, "Little Pig, little Pig, let me
-come in."
-
-"No, no, by the hair of my chinny chin chin."
-
-"Then I'll huff and I'll puff, and I'll blow your house in."
-
-Well, he huffed and he puffed, and he huffed and he puffed, and he
-puffed and he huffed; but he could not get the house down. When he
-found that he could not, with all his huffing and puffing, blow the
-house down, he said, "Little Pig, I know where there is a nice field of
-turnips."
-
-
-"Where?" said the little Pig.
-
-"Oh, in Mr. Smith's home-field; and if you will be ready to-morrow
-morning, I will call for you, and we will go together and get some for
-dinner."
-
-"Very well," said the little Pig, "I will be ready. What time do you
-mean to go?"
-
-"Oh, at six o'clock."
-
-
-Well, the little Pig got up at five, and got the turnips and was home
-again before six. When the Wolf came he said, "Little Pig, are you
-ready?"
-
-"Ready!" said the little Pig, "I have been and come back again, and got
-a nice pot-full for dinner."
-
-
-The Wolf felt very angry at this, but thought that he would be up to
-the little Pig somehow or other; so he said, "Little Pig, I know where
-there is a nice apple-tree."
-
-"Where?" said the Pig.
-
-"Down at Merry-garden," replied the Wolf; "and if you will not deceive
-me I will come for you, at five o'clock to-morrow, and we will go
-together and get some apples."
-
-
-Well, the little Pig woke at four the next morning, and bustled up, and
-went off for the apples, hoping to get back before the Wolf came; but
-he had farther to go, and had to climb the tree, so that just as he was
-coming down from it, he saw the Wolf coming, which, as you may suppose,
-frightened him very much. When the Wolf came up he said, "Little Pig,
-what! are you here before me? Are they nice apples?"
-
-
-"Yes, very," said the little Pig; "I will throw you down one." And he
-threw it so far that, while the Wolf was gone to pick it up, the
-little Pig jumped down and ran home.
-
-
-The next day the Wolf came again, and said to the little Pig, "Little
-Pig, there is a Fair in the Town this afternoon: will you go?"
-
-"Oh, yes," said the Pig, "I will go; what time shall you be ready?"
-
-"At three," said the Wolf.
-
-
-So the little Pig went off before the time, as usual, and got to the
-Fair, and bought a butter churn, and was on his way home with it when he
-saw the Wolf coming. Then he could not tell what to do. So he got into
-the churn to hide, and in doing so turned it round, and it began to
-roll, and rolled down the hill with the Pig inside it, which frightened
-the Wolf so much that he ran home without going to the Fair.
-
-
-He went to the little Pig's house, and told him how frightened he had
-been by a great round thing which came down the hill past him.
-
-Then the little Pig said, "Hah! I frightened you, did I? I had been to
-the Fair and bought a butter churn, and when I saw you I got into it,
-and rolled down the hill."
-
-
-Then the Wolf was very angry indeed, and declared he would eat up the
-little Pig, and that he would get down the chimney after him.
-
-
-When the little Pig saw what he was about, he hung on the pot full of
-water, and made up a blazing fire, and, just as the Wolf was coming
-down, took off the cover of the pot, and in fell the Wolf. And the
-little Pig put on the cover again in an instant, boiled him up, and ate
-him for supper, and lived happy ever after.

stories/The_Tale_of_Benjamin_Bunny.txt

@@ -1,181 +0,0 @@
-The Tale of Benjamin Bunny
-
-One morning a little rabbit sat on a bank.
-
-He pricked his ears and listened to the trit-trot, trit-trot of a pony.
-
-A gig was coming along the road; it was driven by Mr. McGregor, and beside
-him sat Mrs. McGregor in her best bonnet.
-
-As soon as they had passed, little Benjamin Bunny slid down into the road,
-and set off--with a hop, skip, and a jump--to call upon his relations, who
-lived in the wood at the back of Mr. McGregor's garden.
-
-
-That wood was full of rabbit holes; and in the neatest, sandiest hole of
-all lived Benjamin's aunt and his cousins--Flopsy, Mopsy, Cotton-tail, and
-Peter.
-
-Old Mrs. Rabbit was a widow; she earned her living by knitting rabbit-wool
-mittens and muffatees (I once bought a pair at a bazaar). She also sold
-herbs, and rosemary tea, and rabbit-tobacco (which is what we call
-lavender).
-
-Little Benjamin did not very much want to see his Aunt.
-
-He came round the back of the fir-tree, and nearly tumbled upon the top of
-his Cousin Peter.
-
-
-Peter was sitting by himself. He looked poorly, and was dressed in a red
-cotton pocket-handkerchief.
-
-"Peter," said little Benjamin, in a whisper, "who has got your clothes?"
-
-Peter replied, "The scarecrow in Mr. McGregor's garden," and described how
-he had been chased about the garden, and had dropped his shoes and coat.
-
-Little Benjamin sat down beside his cousin and assured him that Mr.
-McGregor had gone out in a gig, and Mrs. McGregor also; and certainly for
-the day, because she was wearing her best bonnet.
-
-
-Peter said he hoped that it would rain.
-
-At this point old Mrs. Rabbit's voice was heard inside the rabbit hole,
-calling: "Cotton-tail! Cotton-tail! fetch some more camomile!"
-
-Peter said he thought he might feel better if he went for a walk.
-
-They went away hand in hand, and got upon the flat top of the wall at the
-bottom of the wood. From here they looked down into Mr. McGregor's garden.
-Peter's coat and shoes were plainly to be seen upon the scarecrow, topped
-with an old tam-o'-shanter of Mr. McGregor's.
-
-
-Little Benjamin said: "It spoils people's clothes to squeeze under a gate;
-the proper way to get in is to climb down a pear-tree."
-
-Peter fell down head first; but it was of no consequence, as the bed below
-was newly raked and quite soft.
-
-It had been sown with lettuces.
-
-They left a great many odd little footmarks all over the bed, especially
-little Benjamin, who was wearing clogs.
-
-
-Little Benjamin said that the first thing to be done was to get back
-Peter's clothes, in order that they might be able to use the
-pocket-handkerchief.
-
-They took them off the scarecrow. There had been rain during the night;
-there was water in the shoes, and the coat was somewhat shrunk.
-
-Benjamin tried on the tam-o'-shanter, but it was too big for him.
-
-Then he suggested that they should fill the pocket-handkerchief with
-onions, as a little present for his Aunt.
-
-Peter did not seem to be enjoying himself; he kept hearing noises.
-
-
-Benjamin, on the contrary, was perfectly at home, and ate a lettuce leaf.
-He said that he was in the habit of coming to the garden with his father
-to get lettuces for their Sunday dinner.
-
-(The name of little Benjamin's papa was old Mr. Benjamin Bunny.)
-
-The lettuces certainly were very fine.
-
-Peter did not eat anything; he said he should like to go home. Presently
-he dropped half the onions.
-
-
-Little Benjamin said that it was not possible to get back up the pear-tree
-with a load of vegetables. He led the way boldly towards the other end of
-the garden. They went along a little walk on planks, under a sunny, red
-brick wall.
-
-The mice sat on their doorsteps cracking cherry-stones; they winked at
-Peter Rabbit and little Benjamin Bunny.
-
-Presently Peter let the pocket-handkerchief go again.
-
-
-They got amongst flower-pots, and frames, and tubs. Peter heard noises
-worse than ever; his eyes were as big as lolly-pops!
-
-He was a step or two in front of his cousin when he suddenly stopped.
-
-This is what those little rabbits saw round that corner!
-
-Little Benjamin took one look, and then, in half a minute less than no
-time, he hid himself and Peter and the onions underneath a large
-basket....
-
-
-The cat got up and stretched herself, and came and sniffed at the basket.
-
-Perhaps she liked the smell of onions!
-
-Anyway, she sat down upon the top of the basket.
-
-She sat there for five hours.
-
-
-I cannot draw you a picture of Peter and Benjamin underneath the basket,
-because it was quite dark, and because the smell of onions was fearful; it
-made Peter Rabbit and little Benjamin cry.
-
-The sun got round behind the wood, and it was quite late in the afternoon;
-but still the cat sat upon the basket.
-
-
-At length there was a pitter-patter, pitter-patter, and some bits of
-mortar fell from the wall above.
-
-The cat looked up and saw old Mr. Benjamin Bunny prancing along the top of
-the wall of the upper terrace.
-
-He was smoking a pipe of rabbit-tobacco, and had a little switch in his
-hand.
-
-He was looking for his son.
-
-Old Mr. Bunny had no opinion whatever of cats.
-
-He took a tremendous jump off the top of the wall on to the top of the
-cat, and cuffed it off the basket, and kicked it into the greenhouse,
-scratching off a handful of fur.
-
-The cat was too much surprised to scratch back.
-
-
-When old Mr. Bunny had driven the cat into the greenhouse, he locked the
-door.
-
-Then he came back to the basket and took out his son Benjamin by the ears,
-and whipped him with the little switch.
-
-Then he took out his nephew Peter.
-
-Then he took out the handkerchief of onions, and marched out of the
-garden.
-
-
-When Mr. McGregor returned about half an hour later he observed several
-things which perplexed him.
-
-It looked as though some person had been walking all over the garden in a
-pair of clogs--only the footmarks were too ridiculously little!
-
-Also he could not understand how the cat could have managed to shut
-herself up inside the greenhouse, locking the door upon the outside.
-
-
-When Peter got home his mother forgave him, because she was so glad to see
-that he had found his shoes and coat. Cotton-tail and Peter folded up the
-pocket-handkerchief, and old Mrs. Rabbit strung up the onions and hung
-them from the kitchen ceiling, with the bunches of herbs and the
-rabbit-tobacco.

stories/The_Tale_of_Jemima_Puddle_Duck.txt

@@ -1,211 +0,0 @@
-The Tale of Jemima Puddle-Duck
-
-What a funny sight it is to see a brood of ducklings with a hen!
-
---Listen to the story of Jemima Puddle-duck, who was annoyed because the
-farmer's wife would not let her hatch her own eggs.
-
-
-Her sister-in-law, Mrs. Rebeccah Puddle-duck, was perfectly willing to
-leave the hatching to some one else--"I have not the patience to sit on a
-nest for twenty-eight days; and no more have you, Jemima. You would let
-them go cold; you know you would!"
-
-"I wish to hatch my own eggs; I will hatch them all by myself," quacked
-Jemima Puddle-duck.
-
-
-She tried to hide her eggs; but they were always found and carried off.
-
-Jemima Puddle-duck became quite desperate. She determined to make a nest
-right away from the farm.
-
-
-She set off on a fine spring afternoon along the cart-road that leads over
-the hill.
-
-She was wearing a shawl and a poke bonnet.
-
-
-When she reached the top of the hill, she saw a wood in the distance.
-
-She thought that it looked a safe quiet spot.
-
-
-Jemima Puddle-duck was not much in the habit of flying. She ran downhill a
-few yards flapping her shawl, and then she jumped off into the air.
-
-
-She flew beautifully when she had got a good start.
-
-She skimmed along over the tree-tops until she saw an open place in the
-middle of the wood, where the trees and brushwood had been cleared.
-
-
-Jemima alighted rather heavily, and began to waddle about in search of a
-convenient dry nesting-place. She rather fancied a tree-stump amongst some
-tall fox-gloves.
-
-But--seated upon the stump, she was startled to find an elegantly dressed
-gentleman reading a newspaper.
-
-He had black prick ears and sandy coloured whiskers.
-
-"Quack?" said Jemima Puddle-duck, with her head and her bonnet on one
-side--"Quack?"
-
-
-The gentleman raised his eyes above his newspaper and looked curiously at
-Jemima--
-
-"Madam, have you lost your way?" said he. He had a long bushy tail which
-he was sitting upon, as the stump was somewhat damp.
-
-Jemima thought him mighty civil and handsome. She explained that she had
-not lost her way, but that she was trying to find a convenient dry
-nesting-place.
-
-
-"Ah! is that so? indeed!" said the gentleman with sandy whiskers, looking
-curiously at Jemima. He folded up the newspaper, and put it in his
-coat-tail pocket.
-
-Jemima complained of the superfluous hen.
-
-"Indeed! how interesting! I wish I could meet with that fowl. I would
-teach it to mind its own business!"
-
-
-"But as to a nest--there is no difficulty: I have a sackful of feathers in
-my wood-shed. No, my dear madam, you will be in nobody's way. You may sit
-there as long as you like," said the bushy long-tailed gentleman.
-
-He led the way to a very retired, dismal-looking house amongst the
-fox-gloves.
-
-It was built of faggots and turf, and there were two broken pails, one on
-top of another, by way of a chimney.
-
-
-"This is my summer residence; you would not find my earth--my winter
-house--so convenient," said the hospitable gentleman.
-
-There was a tumble-down shed at the back of the house, made of old
-soap-boxes. The gentleman opened the door, and showed Jemima in.
-
-
-The shed was almost quite full of feathers--it was almost suffocating; but
-it was comfortable and very soft.
-
-Jemima Puddle-duck was rather surprised to find such a vast quantity of
-feathers. But it was very comfortable; and she made a nest without any
-trouble at all.
-
-
-When she came out, the sandy whiskered gentleman was sitting on a log
-reading the newspaper--at least he had it spread out, but he was looking
-over the top of it.
-
-He was so polite, that he seemed almost sorry to let Jemima go home for
-the night. He promised to take great care of her nest until she came back
-again next day.
-
-He said he loved eggs and ducklings; he should be proud to see a fine
-nestful in his wood-shed.
-
-
-Jemima Puddle-duck came every afternoon; she laid nine eggs in the nest.
-They were greeny white and very large. The foxy gentleman admired them
-immensely. He used to turn them over and count them when Jemima was not
-there.
-
-At last Jemima told him that she intended to begin to sit next day--"and I
-will bring a bag of corn with me, so that I need never leave my nest until
-the eggs are hatched. They might catch cold," said the conscientious
-Jemima.
-
-
-"Madam, I beg you not to trouble yourself with a bag; I will provide oats.
-But before you commence your tedious sitting, I intend to give you a
-treat. Let us have a dinner-party all to ourselves!
-
-"May I ask you to bring up some herbs from the farm-garden to make a
-savoury omelette? Sage and thyme, and mint and two onions, and some
-parsley. I will provide lard for the stuff--lard for the omelette," said
-the hospitable gentleman with sandy whiskers.
-
-
-Jemima Puddle-duck was a simpleton: not even the mention of sage and
-onions made her suspicious.
-
-She went round the farm-garden, nibbling off snippets of all the different
-sorts of herbs that are used for stuffing roast duck.
-
-
-And she waddled into the kitchen, and got two onions out of a basket.
-
-The collie-dog Kep met her coming out, "What are you doing with those
-onions? Where do you go every afternoon by yourself, Jemima Puddle-duck?"
-
-Jemima was rather in awe of the collie; she told him the whole story.
-
-The collie listened, with his wise head on one side; he grinned when she
-described the polite gentleman with sandy whiskers.
-
-
-He asked several questions about the wood, and about the exact position of
-the house and shed.
-
-Then he went out, and trotted down the village. He went to look for two
-fox-hound puppies who were out at walk with the butcher.
-
-
-Jemima Puddle-duck went up the cart-road for the last time, on a sunny
-afternoon. She was rather burdened with bunches of herbs and two onions in
-a bag.
-
-She flew over the wood, and alighted opposite the house of the bushy
-long-tailed gentleman.
-
-
-He was sitting on a log; he sniffed the air, and kept glancing uneasily
-round the wood. When Jemima alighted he quite jumped.
-
-"Come into the house as soon as you have looked at your eggs. Give me the
-herbs for the omelette. Be sharp!"
-
-He was rather abrupt. Jemima Puddle-duck had never heard him speak like
-that.
-
-She felt surprised, and uncomfortable.
-
-
-While she was inside she heard pattering feet round the back of the shed.
-Some one with a black nose sniffed at the bottom of the door, and then
-locked it.
-
-Jemima became much alarmed.
-
-
-A moment afterwards there were most awful noises--barking, baying, growls
-and howls, squealing and groans.
-
-And nothing more was ever seen of that foxy-whiskered gentleman.
-
-Presently Kep opened the door of the shed, and let out Jemima Puddle-duck.
-
-
-Unfortunately the puppies rushed in and gobbled up all the eggs before he
-could stop them.
-
-He had a bite on his ear and both the puppies were limping.
-
-
-Jemima Puddle-duck was escorted home in tears on account of those eggs.
-
-
-She laid some more in June, and she was permitted to keep them herself:
-but only four of them hatched.
-
-Jemima Puddle-duck said that it was because of her nerves; but she had
-always been a bad sitter.

stories/The_Tale_of_Peter_Rabbit.txt

@@ -1,147 +0,0 @@
-The Tale of Peter Rabbit
-
-Once upon a time there were four little Rabbits, and their names
-were--
-
- Flopsy,
- Mopsy,
- Cotton-tail,
-and Peter.
-
-They lived with their Mother in a sand-bank, underneath the root of a
-very big fir-tree.
-
-'Now my dears,' said old Mrs. Rabbit one morning, 'you may go into
-the fields or down the lane, but don't go into Mr. McGregor's garden:
-your Father had an accident there; he was put in a pie by Mrs.
-McGregor.'
-
-
-'Now run along, and don't get into mischief. I am going out.'
-
-Then old Mrs. Rabbit took a basket and her umbrella, and went through
-the wood to the baker's. She bought a loaf of brown bread and five
-currant buns.
-
-
-Flopsy, Mopsy, and Cottontail, who were good little bunnies, went
-down the lane to gather blackberries:
-
-But Peter, who was very naughty, ran straight away to Mr. McGregor's
-garden, and squeezed under the gate!
-
-
-First he ate some lettuces and some French beans; and then he ate
-some radishes;
-
-And then, feeling rather sick, he went to look for some parsley.
-
-
-But round the end of a cucumber frame, whom should he meet but Mr.
-McGregor!
-
-Mr. McGregor was on his hands and knees planting out young cabbages,
-but he jumped up and ran after Peter, waving a rake and calling out,
-'Stop thief!'
-
-
-Peter was most dreadfully frightened; he rushed all over the garden,
-for he had forgotten the way back to the gate.
-
-He lost one of his shoes among the cabbages, and the other shoe
-amongst the potatoes.
-
-After losing them, he ran on four legs and went faster, so that I
-think he might have got away altogether if he had not unfortunately
-run into a gooseberry net, and got caught by the large buttons on his
-jacket. It was a blue jacket with brass buttons, quite new.
-
-
-Peter gave himself up for lost, and shed big tears; but his sobs were
-overheard by some friendly sparrows, who flew to him in great
-excitement, and implored him to exert himself.
-
-Mr. McGregor came up with a sieve, which he intended to pop upon the
-top of Peter; but Peter wriggled out just in time, leaving his jacket
-behind him.
-
-
-And rushed into the tool-shed, and jumped into a can. It would have
-been a beautiful thing to hide in, if it had not had so much water in it.
-
-Mr. McGregor was quite sure that Peter was somewhere in the
-tool-shed, perhaps hidden underneath a flower-pot. He began to turn
-them over carefully, looking under each.
-
-Presently Peter sneezed--'Kertyschoo!' Mr. McGregor was after him in
-no time.
-
-
-And tried to put his foot upon Peter, who jumped out of a window,
-upsetting three plants. The window was too small for Mr. McGregor, and
-he was tired of running after Peter. He went back to his work.
-
-Peter sat down to rest; he was out of breath and trembling with
-fright, and he had not the least idea which way to go. Also he was
-very damp with sitting in that can.
-
-After a time he began to wander about, going lippity--lippity--not
-very fast, and looking all round.
-
-
-He found a door in a wall; but it was locked, and there was no room
-for a fat little rabbit to squeeze underneath.
-
-An old mouse was running in and out over the stone doorstep, carrying
-peas and beans to her family in the wood. Peter asked her the way to
-the gate, but she had such a large pea in her mouth that she could not
-answer. She only shook her head at him. Peter began to cry.
-
-Then he tried to find his way straight across the garden, but he
-became more and more puzzled. Presently, he came to a pond where Mr.
-McGregor filled his water-cans. A white cat was staring at some
-gold-fish, she sat very, very still, but now and then the tip of her
-tail twitched as if it were alive. Peter thought it best to go away
-without speaking to her; he had heard about cats from his cousin,
-little Benjamin Bunny.
-
-
-He went back towards the tool-shed, but suddenly, quite close to him,
-he heard the noise of a hoe--scr-r-ritch, scratch, scratch, scritch.
-Peter scuttered underneath the bushes. But presently, as nothing
-happened, he came out, and climbed upon a wheelbarrow and peeped over.
-The first thing he saw was Mr. McGregor hoeing onions. His back was
-turned towards Peter, and beyond him was the gate!
-
-Peter got down very quietly off the wheelbarrow; and started running
-as fast as he could go, along a straight walk behind some
-black-currant bushes.
-
-Mr. McGregor caught sight of him at the corner, but Peter did not
-care. He slipped underneath the gate, and was safe at last in the wood
-outside the garden.
-
-
-Mr. McGregor hung up the little jacket and the shoes for a scare-crow
-to frighten the blackbirds.
-
-Peter never stopped running or looked behind him till he got home to
-the big fir-tree.
-
-He was so tired that he flopped down upon the nice soft sand on the
-floor of the rabbit-hole and shut his eyes. His mother was busy
-cooking; she wondered what he had done with his clothes. It was the
-second little jacket and pair of shoes that Peter had lost in a
-fortnight!
-
-
-I am sorry to say that Peter was not very well during the evening.
-
-His mother put him to bed, and made some camomile tea; and she gave a
-dose of it to Peter!
-
-'One table-spoonful to be taken at bed-time.'
-
-
-But Flopsy, Mopsy, and Cotton-tail had bread and milk and
-blackberries for supper.

stories/The_Tale_of_Tom_Kitten.txt

@@ -1,119 +0,0 @@
-The Tale of Tom Kitten
-
-Once upon a time there were three little kittens, and their names were
-Mittens, Tom Kitten, and Moppet.
-
-They had dear little fur coats of their own; and they tumbled about the
-doorstep and played in the dust.
-
-But one day their mother--Mrs. Tabitha Twitchit--expected friends to tea;
-so she fetched the kittens indoors, to wash and dress them, before the
-fine company arrived.
-
-
-First she scrubbed their faces (this one is Moppet).
-
-Then she brushed their fur, (this one is Mittens).
-
-
-Then she combed their tails and whiskers (this is Tom Kitten).
-
-Tom was very naughty, and he scratched.
-
-Mrs. Tabitha dressed Moppet and Mittens in clean pinafores and tuckers;
-and then she took all sorts of elegant uncomfortable clothes out of a
-chest of drawers, in order to dress up her son Thomas.
-
-
-Tom Kitten was very fat, and he had grown; several buttons burst off. His
-mother sewed them on again.
-
-When the three kittens were ready, Mrs. Tabitha unwisely turned them out
-into the garden, to be out of the way while she made hot buttered toast.
-
-"Now keep your frocks clean, children! You must walk on your hind legs.
-Keep away from the dirty ash-pit, and from Sally Henny Penny, and from the
-pig-stye and the Puddle-Ducks."
-
-
-Moppet and Mittens walked down the garden path unsteadily. Presently they
-trod upon their pinafores and fell on their noses.
-
-When they stood up there were several green smears!
-
-"Let us climb up the rockery, and sit on the garden wall," said Moppet.
-
-They turned their pinafores back to front, and went up with a skip and a
-jump; Moppet's white tucker fell down into the road.
-
-
-Tom Kitten was quite unable to jump when walking upon his hind legs in
-trousers. He came up the rockery by degrees, breaking the ferns, and
-shedding buttons right and left.
-
-He was all in pieces when he reached the top of the wall.
-
-Moppet and Mittens tried to pull him together; his hat fell off, and the
-rest of his buttons burst.
-
-
-While they were in difficulties, there was a pit pat paddle pat! and the
-three Puddle-Ducks came along the hard high road, marching one behind the
-other and doing the goose step--pit pat paddle pat! pit pat waddle pat!
-
-They stopped and stood in a row, and stared up at the kittens. They had
-very small eyes and looked surprised.
-
-
-Then the two duck-birds, Rebeccah and Jemima Puddle-Duck, picked up the
-hat and tucker and put them on.
-
-Mittens laughed so that she fell off the wall. Moppet and Tom descended
-after her; the pinafores and all the rest of Tom's clothes came off on the
-way down.
-
-"Come! Mr. Drake Puddle-Duck," said Moppet--"Come and help us to dress
-him! Come and button up Tom!"
-
-
-Mr. Drake Puddle-Duck advanced in a slow sideways manner, and picked up
-the various articles.
-
-But he put them on himself! They fitted him even worse than Tom Kitten.
-
-"It's a very fine morning!" said Mr. Drake Puddle-Duck.
-
-
-And he and Jemima and Rebeccah Puddle-Duck set off up the road, keeping
-step--pit pat, paddle pat! pit pat, waddle pat!
-
-Then Tabitha Twitchit came down the garden and found her kittens on the
-wall with no clothes on.
-
-
-She pulled them off the wall, smacked them, and took them back to the
-house.
-
-"My friends will arrive in a minute, and you are not fit to be seen; I am
-affronted," said Mrs. Tabitha Twitchit.
-
-She sent them upstairs; and I am sorry to say she told her friends that
-they were in bed with the measles; which was not true.
-
-
-Quite the contrary; they were not in bed: not in the least.
-
-Somehow there were very extraordinary noises over-head, which disturbed
-the dignity and repose of the tea party.
-
-And I think that some day I shall have to make another, larger, book, to
-tell you more about Tom Kitten!
-
-
-As for the Puddle-Ducks--they went into a pond.
-
-The clothes all came off directly, because there were no buttons.
-
-
-And Mr. Drake Puddle-Duck, and Jemima and Rebeccah, have been looking for
-them ever since.

story_downloader/clean_stories.py

@@ -1,378 +0,0 @@
-"""
-Clean downloaded Gutenberg story files for TTS audiobook use.
-
-Reference format: Three_LIttle_Pigs.txt
-  - Line 1: TITLE (all caps or title case)
-  - Line 2: blank
-  - Remaining: story text only (no metadata, illustrations, publisher info)
-
-This script:
-  1. Strips Gutenberg header (eBook preamble, author, language, credits, etc.)
-  2. Strips Gutenberg footer (license boilerplate)
-  3. Removes [Illustration] / [Illustration: ...] tags
-  4. Removes publisher info, title pages, "Note:" blocks
-  5. Removes _emphasis_ underscores (keeps the word)
-  6. Removes BOM characters, excessive blank lines
-  7. Writes cleaned files back in-place
-"""
-
-import os
-import re
-from pathlib import Path
-
-STORIES_DIR = Path(__file__).parent.parent / "stories"
-REFERENCE_FILE = "Three_LIttle_Pigs.txt"  # already clean, skip it
-
-# Patterns that mark the START of Gutenberg header material (first line is title)
-HEADER_PATTERNS = [
-    r"The Project Gutenberg eBook",
-    r"^\u feffThe Project Gutenberg",  # BOM variant
-    r"^This eBook is for the use of",
-    r"^Title:",
-    r"^Author:",
-    r"^Release date:",
-    r"^Language:",
-    r"^Credits:",
-    r"^Other information and formats:",
-    r"^Illustrator:",
-    r"^Editor:",
-    r"^Most recently updated:",
-]
-
-# Patterns that mark the START of Gutenberg footer
-FOOTER_MARKERS = [
-    "End of the Project Gutenberg",
-    "End of Project Gutenberg",
-    "Updated editions will replace",
-    "*** END OF THE PROJECT GUTENBERG",
-    "*** END OF THIS PROJECT GUTENBERG",
-    "Uniform With This Volume",
-    "UNIFORMLY WITH THIS",
-    "PUBLISHED\nUNIFORMLY",
-    "* * * * *\n\n\nUniform",
-]
-
-# Lines to remove entirely (exact or pattern match)
-REMOVE_LINE_PATTERNS = [
-    re.compile(r"^\[Illustration[:\]].*$", re.IGNORECASE),  # [Illustration] or [Illustration: ...]
-    re.compile(r"^\[Illustration\]$", re.IGNORECASE),
-    re.compile(r"^Note:.*Project Gutenberg.*$", re.IGNORECASE),
-    re.compile(r"^E-text prepared by.*$", re.IGNORECASE),
-    re.compile(r"^Transcriber.s Note.*$", re.IGNORECASE),
-    re.compile(r"^\s*https?://.*$"),  # bare URLs
-    re.compile(r"^\s*\(https?://.*\)\s*$"),  # (URLs)
-    re.compile(r"^\s*www\.gutenberg\.org.*$", re.IGNORECASE),
-    re.compile(r"^\s*See \d+-h\.htm.*$"),
-    re.compile(r"^\s*Images of the original pages.*$", re.IGNORECASE),
-    re.compile(r"^\s*Internet Archive.*$", re.IGNORECASE),
-    # Gutenberg metadata fields
-    re.compile(r"^\s*Author:.*$", re.IGNORECASE),
-    re.compile(r"^\s*Editor:.*$", re.IGNORECASE),
-    re.compile(r"^\s*Illustrator:.*$", re.IGNORECASE),
-    re.compile(r"^\s*Title:.*$", re.IGNORECASE),
-    re.compile(r"^\s*Release date:.*$", re.IGNORECASE),
-    re.compile(r"^\s*Most recently updated:.*$", re.IGNORECASE),
-    re.compile(r"^\s*Language:.*$", re.IGNORECASE),
-    re.compile(r"^\s*Other information and formats:.*$", re.IGNORECASE),
-    re.compile(r"^\s*Credits:.*$", re.IGNORECASE),
-    re.compile(r"^\s*\*\s*\*\s*\*\s*\*\s*\*\s*$"),  # * * * * * dividers
-]
-
-# Publisher/title-page noise patterns (only applied in the header zone, before story starts)
-TITLE_PAGE_PATTERNS = [
-    re.compile(r"^\s*(BY|by)\s*$"),
-    re.compile(r"^\s*PRINTED IN.*$", re.IGNORECASE),
-    re.compile(r"^\s*COPYRIGHT.*$", re.IGNORECASE),
-    re.compile(r"^\s*PUBLISHED BY.*$", re.IGNORECASE),
-    re.compile(r"^\s*FREDERICK WARNE.*$", re.IGNORECASE),
-    re.compile(r"^\s*First published.*$", re.IGNORECASE),
-    re.compile(r"^\s*Printed and bound.*$", re.IGNORECASE),
-    re.compile(r"^\s*LONDON\.?\s*$", re.IGNORECASE),
-    re.compile(r"^\s*NEW YORK\.?\s*$", re.IGNORECASE),
-    re.compile(r"^\s*Dodd, Mead.*$", re.IGNORECASE),
-    re.compile(r"^\s*One Shilling Net\.?\s*$", re.IGNORECASE),
-    re.compile(r"^\s*With Drawings by.*$", re.IGNORECASE),
-    re.compile(r"^\s*With the Original Coloured.*$", re.IGNORECASE),
-    re.compile(r"^\s*Containing\s*$", re.IGNORECASE),
-    re.compile(r"^\s*_MARKS.S EDITION\._\s*$"),
-    re.compile(r"^\s*SAALFIELD PUBLISHING.*$", re.IGNORECASE),
-    re.compile(r"^\s*CHICAGO.*AKRON.*$", re.IGNORECASE),
-    re.compile(r"^\s*Online Distributed Proofreading.*$", re.IGNORECASE),
-    re.compile(r"^\s*Collections, University Libraries.*$", re.IGNORECASE),
-    re.compile(r"^\s*Book Cover\s*$", re.IGNORECASE),
-    re.compile(r"^\s*Edited by.*$", re.IGNORECASE),
-    re.compile(r"^\s*An Old English\s*$", re.IGNORECASE),
-    re.compile(r"^\s*Folk Tale\s*$", re.IGNORECASE),
-    re.compile(r"^\s*Retold\s*$", re.IGNORECASE),
-    re.compile(r"^\s*and\s*$"),
-    re.compile(r"^\s*or\s*$"),
-    re.compile(r"^\s*Illustrated\s*$", re.IGNORECASE),
-]
-
-
-def is_title_line(line: str, title: str) -> bool:
-    """Check if a line is essentially a repetition of the story title."""
-    stripped = line.strip().strip("_").strip("*").strip().rstrip(".")
-    if not stripped or len(stripped) < 5:
-        return False
-    # Normalize both for comparison
-    norm_line = re.sub(r"[^a-z\s]", "", stripped.lower()).split()
-    norm_title = re.sub(r"[^a-z\s]", "", title.lower()).split()
-    if not norm_line or not norm_title:
-        return False
-    # The line must match the title closely (not just share a few words)
-    # At least 80% of title words must appear, and line can't be much longer
-    overlap = len(set(norm_line) & set(norm_title))
-    return overlap >= len(norm_title) * 0.8 and len(norm_line) <= len(norm_title) + 3
-
-
-def find_story_start(lines: list[str], title: str) -> int:
-    """Find where the actual story narrative begins, past all header/title-page material."""
-    # Strategy: look for the LAST occurrence of the title in the header zone
-    # (first 30% of file), then find the first real narrative paragraph after it.
-    # Limit search to header zone to avoid matching title words in story text.
-    header_zone_end = min(len(lines), max(50, len(lines) // 3))
-
-    last_title_line = 0
-    for i in range(header_zone_end):
-        if is_title_line(lines[i], title):
-            last_title_line = i
-
-    # Now find the first narrative line after the last title occurrence
-    # A narrative line is: not empty, not a metadata line, not all caps short line,
-    # and contains actual sentence-like text
-    search_start = max(last_title_line + 1, 1)
-    for i in range(search_start, len(lines)):
-        line = lines[i].strip()
-        if not line:
-            continue
-        # Skip short all-caps lines (chapter headings on title page)
-        if line.isupper() and len(line) < 60:
-            continue
-        # Skip [Illustration] lines
-        if line.startswith("[Illustration"):
-            continue
-        # Skip publisher/metadata lines
-        if any(p.match(line) for p in TITLE_PAGE_PATTERNS):
-            continue
-        if any(p.match(line) for p in REMOVE_LINE_PATTERNS):
-            continue
-        # Skip "Author of..." attribution lines
-        if re.match(r'^Author of\b', line, re.IGNORECASE):
-            continue
-        # Skip publisher names
-        if re.match(r'^Frederick Warne', line, re.IGNORECASE):
-            continue
-        # Skip dedication blocks
-        if re.match(r'^DEDICATED\b', line, re.IGNORECASE):
-            continue
-        # Skip partial title fragments (single title words on their own line)
-        if line.isupper() and len(line.split()) <= 4:
-            continue
-        # Skip table-of-contents style lines (semicolons separating titles)
-        if line.count(";") >= 2 and not re.search(r'[.!?]', line):
-            continue
-        # Skip lines ending with just a colon (TOC entries, subtitles)
-        if re.match(r'^[^.!?]+:$', line):
-            continue
-        # Skip lines that are just a year (e.g. "1907 by Frederick Warne")
-        if re.match(r'^\d{4}\b', line):
-            continue
-        # Must contain lowercase letters (actual prose)
-        if re.search(r"[a-z]", line) and len(line) > 20:
-            # Final check: would clean_line remove this?
-            if clean_line(lines[i]) is not None:
-                return i
-
-    return search_start
-
-
-def find_story_end(text: str) -> int:
-    """Find where Gutenberg footer begins. Returns char index or len(text)."""
-    for marker in FOOTER_MARKERS:
-        idx = text.find(marker)
-        if idx >= 0:
-            return idx
-    return len(text)
-
-
-def clean_line(line: str) -> str | None:
-    """Clean a single line. Returns None if line should be removed entirely."""
-    # Remove BOM
-    line = line.replace("\ufeff", "")
-
-    # Remove [Illustration] and [Illustration: ...]
-    line = re.sub(r"\[Illustration[:\s][^\]]*\]", "", line)
-    line = re.sub(r"\[Illustration\]", "", line)
-
-    # Remove _emphasis_ underscores but keep the word
-    line = re.sub(r"_([^_]+)_", r"\1", line)
-
-    # Remove Gutenberg eBook header line
-    if "Project Gutenberg eBook" in line:
-        return None
-    # Remove license preamble
-    if "This eBook is for the use of anyone" in line:
-        return None
-    # Remove proofreading/credit lines
-    if "Distributed Proofreading" in line or "Proofreading Team" in line:
-        return None
-    if "pgdp.net" in line or "dp.rastko.net" in line:
-        return None
-    if "Project Gutenberg License" in line:
-        return None
-    # Remove publisher lines that may appear mid-file
-    if re.match(r"^\s*Frederick Warne", line.strip()):
-        return None
-    if re.match(r"^\s*Author of\b", line.strip(), re.IGNORECASE):
-        return None
-    # Remove dedication lines
-    if re.match(r"^\s*DEDICATED\b", line.strip()):
-        return None
-    # Remove author name lines (all caps, short)
-    if re.match(r"^\s*BEATRIX POTTER\s*$", line.strip()):
-        return None
-    if re.match(r"^\s*WALTER CRANE\s*$", line.strip()):
-        return None
-    # Remove quoted title reference lines ("The Tale of...", &c.)
-    if re.match(r'^\s*["\u201c].*["\u201d],?\s*&c\.?\s*$', line.strip()):
-        return None
-    # Remove printer/publisher lines
-    if re.match(r"^\s*William Clowes", line.strip(), re.IGNORECASE):
-        return None
-    # Remove dedication lines (TO ALL / PICKLES / --ESPECIALLY...)
-    stripped_check = line.strip()
-    if re.match(r"^(TO ALL|PICKLES|--ESPECIALLY)", stripped_check):
-        return None
-    if re.match(r"^GET UPON MY", stripped_check):
-        return None
-
-    # Check if line matches any remove pattern
-    stripped = line.strip()
-    for pattern in REMOVE_LINE_PATTERNS:
-        if pattern.match(stripped):
-            return None
-
-    return line
-
-
-def clean_story(filepath: Path) -> bool:
-    """Clean a single story file. Returns True if modified."""
-    with open(filepath, "r", encoding="utf-8") as f:
-        raw = f.read()
-
-    # The first line is the title (from our download script)
-    lines = raw.split("\n")
-    title = lines[0].strip().replace("\ufeff", "")
-
-    # Find where footer starts and cut it
-    footer_pos = find_story_end(raw)
-    if footer_pos < len(raw):
-        # Find the line index corresponding to footer_pos
-        char_count = 0
-        footer_line = len(lines)
-        for i, line in enumerate(lines):
-            char_count += len(line) + 1  # +1 for \n
-            if char_count >= footer_pos:
-                footer_line = i
-                break
-        lines = lines[:footer_line]
-
-    # Find where actual story starts
-    story_start = find_story_start(lines, title)
-
-    # Extract just the story lines
-    story_lines = lines[story_start:]
-
-    # Clean each line
-    cleaned = []
-    for line in story_lines:
-        result = clean_line(line)
-        if result is not None:
-            cleaned.append(result)
-
-    # Collapse multiple blank lines into max 2
-    final_lines = cleaned
-    output_lines = []
-    blank_count = 0
-    for line in final_lines:
-        if line.strip() == "":
-            blank_count += 1
-            if blank_count <= 2:
-                output_lines.append("")
-        else:
-            blank_count = 0
-            output_lines.append(line)
-
-    # Strip trailing blank lines
-    while output_lines and output_lines[-1].strip() == "":
-        output_lines.pop()
-
-    # Build final text: TITLE\n\nstory_text\n
-    story_text = "\n".join(output_lines)
-
-    # Clean up any remaining artifacts
-    # Remove "Transcriber's Note" blocks at the end
-    story_text = re.sub(
-        r"\n\s*Transcriber.s Note.*$", "", story_text, flags=re.DOTALL | re.IGNORECASE
-    )
-
-    # Remove any "Obvious punctuation..." notes
-    story_text = re.sub(
-        r"\n\s*\*\s*Obvious punctuation.*$", "", story_text, flags=re.DOTALL | re.IGNORECASE
-    )
-
-    # Remove trailing publisher catalogs / book lists
-    story_text = re.sub(
-        r"\n\s*\*[\s*]+\*\s*\n.*$", "", story_text, flags=re.DOTALL
-    )
-    story_text = re.sub(
-        r"\n\s*PUBLISHED\s*\n.*$", "", story_text, flags=re.DOTALL | re.IGNORECASE
-    )
-    story_text = re.sub(
-        r"\n\s*Uniform With This.*$", "", story_text, flags=re.DOTALL | re.IGNORECASE
-    )
-    story_text = re.sub(
-        r"\n\s*UNIFORMLY? WITH THIS.*$", "", story_text, flags=re.DOTALL | re.IGNORECASE
-    )
-
-    # Remove trailing "THE END" marker
-    story_text = re.sub(r"\n\s*THE END\s*$", "", story_text, flags=re.IGNORECASE)
-
-    final = f"{title}\n\n{story_text.strip()}\n"
-
-    with open(filepath, "w", encoding="utf-8") as f:
-        f.write(final)
-
-    word_count = len(story_text.split())
-    print(f"  Cleaned: {filepath.name} ({word_count} words)")
-    return True
-
-
-def main():
-    if not STORIES_DIR.exists():
-        print(f"Stories directory not found: {STORIES_DIR}")
-        return
-
-    files = sorted(STORIES_DIR.glob("*.txt"))
-    cleaned = 0
-    skipped = 0
-
-    for filepath in files:
-        if filepath.name == REFERENCE_FILE:
-            print(f"  Skipped (reference): {filepath.name}")
-            skipped += 1
-            continue
-
-        print(f"\n--- {filepath.name} ---")
-        try:
-            clean_story(filepath)
-            cleaned += 1
-        except Exception as e:
-            print(f"  ERROR: {e}")
-
-    print(f"\n=== Done: {cleaned} cleaned, {skipped} skipped ===")
-
-
-if __name__ == "__main__":
-    main()

story_downloader/download_stories.py

@@ -1,90 +0,0 @@
-"""
-Download 10 short children's stories from Project Gutenberg
-and save them as text files under ../stories/
-
-Uses direct cache URLs (more reliable than page scraping)
-and the GutenbergDownloader's parse_text_book to strip headers/footers.
-"""
-
-import sys
-import os
-import requests
-import time
-
-sys.path.insert(0, os.path.dirname(__file__))
-from gutenberg_downloader import GutenbergDownloader
-from pathlib import Path
-
-# 10 short children's stories known to have plain text on Gutenberg
-STORIES = [
-    {"id": 14838, "title": "The Tale of Peter Rabbit"},
-    {"id": 14407, "title": "The Tale of Benjamin Bunny"},
-    {"id": 14814, "title": "The Tale of Jemima Puddle-Duck"},
-    {"id": 14837, "title": "The Tale of Tom Kitten"},
-    {"id": 1988,  "title": "The History of Tom Thumb"},
-    {"id": 18155, "title": "The Story of the Three Little Pigs"},
-    {"id": 18735, "title": "The Little Red Hen"},
-    {"id": 25877, "title": "The Little Gingerbread Man"},
-    {"id": 23521, "title": "The Sleeping Beauty"},
-    {"id": 37529, "title": "The Adventures of Puss in Boots"},
-]
-
-# Direct URL patterns Gutenberg uses (try in order)
-URL_PATTERNS = [
-    "https://www.gutenberg.org/cache/epub/{id}/pg{id}.txt",
-    "https://www.gutenberg.org/files/{id}/{id}-0.txt",
-    "https://www.gutenberg.org/files/{id}/{id}.txt",
-]
-
-
-def download_raw(book_id: int) -> str | None:
-    """Try direct Gutenberg cache/file URLs to get plain text."""
-    for pattern in URL_PATTERNS:
-        url = pattern.format(id=book_id)
-        try:
-            r = requests.get(url, timeout=15)
-            if r.status_code == 200 and len(r.text) > 500:
-                print(f"  Found at: {url}")
-                return r.text
-        except requests.RequestException:
-            continue
-    return None
-
-
-def main():
-    downloader = GutenbergDownloader()
-    stories_dir = Path(__file__).parent.parent / "stories"
-    stories_dir.mkdir(parents=True, exist_ok=True)
-
-    success = 0
-    failed = 0
-
-    for story in STORIES:
-        filename = story["title"].replace(" ", "_").replace("'", "").replace("-", "_")
-        print(f"\n--- {story['title']} (#{story['id']}) ---")
-
-        raw = download_raw(story["id"])
-        if not raw:
-            print(f"  FAILED to download")
-            failed += 1
-            continue
-
-        # Use the downloader's parser to strip Gutenberg boilerplate
-        book_data = downloader.parse_text_book(raw)
-        text = book_data.get("main_text", raw) if book_data else raw
-        title = book_data.get("title", story["title"]) if book_data else story["title"]
-
-        output_file = stories_dir / f"{filename}.txt"
-        with open(output_file, "w", encoding="utf-8") as f:
-            f.write(f"{title}\n\n{text}\n")
-
-        words = len(text.split())
-        print(f"  Saved: {output_file.name} ({words} words)")
-        success += 1
-        time.sleep(1)  # be polite to Gutenberg servers
-
-    print(f"\n=== Done: {success} succeeded, {failed} failed ===")
-
-
-if __name__ == "__main__":
-    main()

story_downloader/example_usage.py

@@ -1,296 +0,0 @@
-"""
-Project Gutenberg Downloader - Example Usage
-
-This script demonstrates how to use the GutenbergDownloader to download
-and process free e-books from Project Gutenberg.
-
-Project Gutenberg URLs:
-- https://www.gutenberg.org/ebooks/11 - Alice's Adventures in Wonderland
-- https://www.gutenberg.org/ebooks/1342 - Pride and Prejudice
-- https://www.gutenberg.org/ebooks/98 - A Tale of Two Cities
-- https://www.gutenberg.org/ebooks/219 - Heart of Darkness
-- https://www.gutenberg.org/ebooks/514 - Little Women
-- https://www.gutenberg.org/ebooks/4300 - Ulysses
-- https://www.gutenberg.org/ebooks/1661 - Sherlock Holmes - A Study in Scarlet
-"""
-
-import json
-from pathlib import Path
-from gutenberg_downloader import GutenbergDownloader
-
-
-def example_1_single_book():
-    """Example 1: Download and process a single book."""
-    print("\n" + "=" * 70)
-    print("Example 1: Download and Process a Single Book")
-    print("=" * 70)
-
-    downloader = GutenbergDownloader(cache_dir="./gutenberg_cache")
-
-    # Download Alice in Wonderland
-    book_url = "https://www.gutenberg.org/ebooks/11"
-    print(f"\nDownloading from: {book_url}")
-
-    content = downloader.download_book(book_url, format_type="text")
-
-    if content:
-        print(f"Downloaded {len(content)} characters")
-
-        # Parse the book
-        book_data = downloader.parse_text_book(content)
-
-        print(f"\nBook Title: {book_data['title']}")
-        print(f"Chapters found: {len(book_data['chapters'])}")
-        print(f"Main text length: {len(book_data['main_text'])} characters")
-
-        # Display first chapter
-        if book_data['chapters']:
-            print(f"\nFirst chapter: {book_data['chapters'][0]}")
-
-        # Display first 500 characters of main text
-        print(f"\nFirst 500 characters of main text:")
-        print(book_data['main_text'][:500])
-
-        # Save to file
-        output_file = Path("./processed_books/alice.json")
-        output_file.parent.mkdir(parents=True, exist_ok=True)
-        with open(output_file, 'w', encoding='utf-8') as f:
-            json.dump(book_data, f, indent=2, ensure_ascii=False)
-        print(f"\nSaved to: {output_file}")
-    else:
-        print("Failed to download book")
-
-
-def example_2_multiple_books():
-    """Example 2: Download and process multiple books."""
-    print("\n" + "=" * 70)
-    print("Example 2: Batch Download Multiple Books")
-    print("=" * 70)
-
-    downloader = GutenbergDownloader(cache_dir="./gutenberg_cache")
-
-    # List of books to download
-    books = [
-        ("https://www.gutenberg.org/ebooks/11", "Alice in Wonderland"),
-        ("https://www.gutenberg.org/ebooks/1342", "Pride and Prejudice"),
-        ("https://www.gutenberg.org/ebooks/98", "A Tale of Two Cities"),
-    ]
-
-    results = downloader.process_books(
-        [book_url for book_url, _ in books],
-        format_type="text",
-        output_dir="./processed_books"
-    )
-
-    print(f"\nProcessed {len(results)} books:\n")
-    for i, result in enumerate(results, 1):
-        if result['status'] == 'success':
-            print(f"{i}. {result['title']}")
-            print(f"   File: {result['file']}")
-
-            # Load and display stats
-            with open(result['file'], 'r', encoding='utf-8') as f:
-                data = json.load(f)
-                print(f"   Chapters: {len(data['chapters'])}")
-                print(f"   Text length: {len(data['main_text'])} characters")
-        else:
-            print(f"{i}. FAILED: {result['url']}")
-        print()
-
-
-def example_3_process_and_extract():
-    """Example 3: Process a book and extract specific information."""
-    print("\n" + "=" * 70)
-    print("Example 3: Process and Extract Specific Information")
-    print("=" * 70)
-
-    downloader = GutenbergDownloader(cache_dir="./gutenberg_cache")
-
-    # Download Pride and Prejudice
-    book_url = "https://www.gutenberg.org/ebooks/1342"
-    print(f"\nDownloading: {book_url}")
-
-    content = downloader.download_book(book_url, format_type="text")
-
-    if content:
-        book_data = downloader.parse_text_book(content)
-
-        print(f"\nTitle: {book_data['title']}")
-        print(f"Format: {book_data['format']}")
-        print(f"Source: {book_data['source']}")
-
-        # Extract and display chapters
-        print(f"\n--- Chapter Titles ({len(book_data['chapters'])} found) ---")
-        for i, chapter in enumerate(book_data['chapters'][:10], 1):
-            print(f"{i}. {chapter[:60]}")  # Truncate for display
-
-        # Extract and display statistics
-        print(f"\n--- Content Statistics ---")
-        print(f"Total characters: {len(book_data['main_text']):,}")
-        print(f"Total words (approx): {len(book_data['main_text'].split()):,}")
-        print(f"Average chapter length: {len(book_data['main_text']) / len(book_data['chapters']):.0f} characters")
-
-        # Display text sample
-        print(f"\n--- Text Sample (first 800 characters) ---")
-        print(book_data['main_text'][:800])
-        print("...")
-
-
-def example_4_save_as_text():
-    """Example 4: Save extracted book as plain text file."""
-    print("\n" + "=" * 70)
-    print("Example 4: Save Book as Plain Text File")
-    print("=" * 70)
-
-    downloader = GutenbergDownloader(cache_dir="./gutenberg_cache")
-
-    # Download Little Women
-    book_url = "https://www.gutenberg.org/ebooks/514"
-    print(f"\nDownloading: {book_url}")
-
-    content = downloader.download_book(book_url, format_type="text")
-
-    if content:
-        book_data = downloader.parse_text_book(content)
-
-        # Create output file
-        output_file = Path("./processed_books/little_women.txt")
-        output_file.parent.mkdir(parents=True, exist_ok=True)
-
-        with open(output_file, 'w', encoding='utf-8') as f:
-            # Write title
-            f.write(f"{'='*70}\n")
-            f.write(f"{book_data['title']}\n")
-            f.write(f"{'='*70}\n\n")
-
-            # Write chapter list
-            if book_data['chapters']:
-                f.write("CHAPTERS:\n")
-                for chapter in book_data['chapters']:
-                    f.write(f"  - {chapter}\n")
-                f.write("\n" + "="*70 + "\n\n")
-
-            # Write main text
-            f.write(book_data['main_text'])
-
-        print(f"Saved to: {output_file}")
-        print(f"File size: {output_file.stat().st_size:,} bytes")
-
-
-def example_5_extract_first_chapter():
-    """Example 5: Extract and save only the first chapter."""
-    print("\n" + "=" * 70)
-    print("Example 5: Extract and Save First Chapter")
-    print("=" * 70)
-
-    downloader = GutenbergDownloader(cache_dir="./gutenberg_cache")
-
-    # Download A Tale of Two Cities
-    book_url = "https://www.gutenberg.org/ebooks/98"
-    print(f"\nDownloading: {book_url}")
-
-    content = downloader.download_book(book_url, format_type="text")
-
-    if content:
-        book_data = downloader.parse_text_book(content)
-
-        print(f"\nTitle: {book_data['title']}")
-        print(f"Chapters: {len(book_data['chapters'])}")
-
-        # Find first chapter marker in text
-        if book_data['chapters']:
-            first_chapter = book_data['chapters'][0]
-            print(f"\nFirst chapter: {first_chapter}")
-
-            # Save first chapter metadata
-            chapter_data = {
-                'book_title': book_data['title'],
-                'chapter_title': first_chapter,
-                'chapter_number': 1,
-                'text_preview': book_data['main_text'][:1000]
-            }
-
-            output_file = Path("./processed_books/chapter_extract.json")
-            output_file.parent.mkdir(parents=True, exist_ok=True)
-            with open(output_file, 'w', encoding='utf-8') as f:
-                json.dump(chapter_data, f, indent=2, ensure_ascii=False)
-
-            print(f"\nSaved chapter data to: {output_file}")
-
-
-def example_6_api_usage():
-    """Example 6: Using the downloader as a Python API."""
-    print("\n" + "=" * 70)
-    print("Example 6: Python API Usage")
-    print("=" * 70)
-
-    # Initialize downloader
-    downloader = GutenbergDownloader(cache_dir="./gutenberg_cache")
-
-    # Download a book
-    print("\nDownloading book...")
-    content = downloader.download_book(
-        "https://www.gutenberg.org/ebooks/11",
-        format_type="text"
-    )
-
-    # Parse the book
-    print("Parsing book...")
-    book_data = downloader.parse_text_book(content)
-
-    # Access data programmatically
-    print(f"\nBook Title: {book_data['title']}")
-    print(f"Format: {book_data['format']}")
-    print(f"Source: {book_data['source']}")
-    print(f"Chapters: {len(book_data['chapters'])}")
-
-    # Use the data in your application
-    book_json = json.dumps(book_data, ensure_ascii=False)
-    print(f"\nJSON representation size: {len(book_json):,} bytes")
-
-
-def main():
-    """Run all examples."""
-    print("\n")
-    print("#" * 70)
-    print("# Project Gutenberg Downloader - Usage Examples")
-    print("#" * 70)
-
-    # Run examples
-    try:
-        example_1_single_book()
-    except Exception as e:
-        print(f"Example 1 error: {e}")
-
-    try:
-        example_2_multiple_books()
-    except Exception as e:
-        print(f"Example 2 error: {e}")
-
-    try:
-        example_3_process_and_extract()
-    except Exception as e:
-        print(f"Example 3 error: {e}")
-
-    try:
-        example_4_save_as_text()
-    except Exception as e:
-        print(f"Example 4 error: {e}")
-
-    try:
-        example_5_extract_first_chapter()
-    except Exception as e:
-        print(f"Example 5 error: {e}")
-
-    try:
-        example_6_api_usage()
-    except Exception as e:
-        print(f"Example 6 error: {e}")
-
-    print("\n" + "=" * 70)
-    print("All examples completed!")
-    print("=" * 70 + "\n")
-
-
-if __name__ == "__main__":
-    main()

story_downloader/gutenberg_downloader.py

@@ -1,423 +0,0 @@
-"""
-Project Gutenberg E-Book Downloader and Cleaner
-
-Downloads and processes free e-books from Project Gutenberg.
-Supports both Plain TEXT UTF-8 and EPUB formats.
-Outputs cleaned text with title, chapter titles, and main content.
-"""
-
-import re
-import requests
-import os
-import logging
-from typing import List, Dict, Optional, Tuple
-from pathlib import Path
-from urllib.parse import urljoin, urlparse
-import json
-
-# Try to import ebooklib for EPUB support
-try:
-    from ebooklib import epub
-    EPUB_SUPPORT = True
-except ImportError:
-    EPUB_SUPPORT = False
-
-# Try to import lxml for HTML parsing
-try:
-    from lxml import html
-    LXML_SUPPORT = True
-except ImportError:
-    LXML_SUPPORT = False
-
-# Configure logging
-logging.basicConfig(
-    level=logging.INFO,
-    format='%(asctime)s - %(name)s - %(levelname)s - %(message)s'
-)
-logger = logging.getLogger(__name__)
-
-
-class GutenbergDownloader:
-    """Downloads and processes e-books from Project Gutenberg."""
-
-    GUTENBERG_URL = "https://www.gutenberg.org"
-
-    # Common Gutenberg headers/footers patterns to remove
-    FOOTER_PATTERNS = [
-        r'\*\*\*.*?END.*?PROJECT GUTENBERG.*?\*\*\*',
-        r'End of the Project Gutenberg.*',
-        r'This eBook is for the use of anyone.*?freely under.*?\.',
-    ]
-
-    HEADER_PATTERNS = [
-        r'\*\*\*.*?START.*?PROJECT GUTENBERG.*?\*\*\*',
-        r'Produced by.*?\n',
-        r'This eBook is for the use of anyone.*?freely under.*?\.',
-    ]
-
-    def __init__(self, cache_dir: str = "./gutenberg_cache"):
-        """Initialize downloader with optional caching."""
-        self.cache_dir = Path(cache_dir)
-        self.cache_dir.mkdir(parents=True, exist_ok=True)
-        self.session = requests.Session()
-        self.session.headers.update({
-            'User-Agent': 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36'
-        })
-
-    def download_book(self, book_url: str, format_type: str = "text") -> Optional[str]:
-        """
-        Download a book from Project Gutenberg.
-
-        Args:
-            book_url: URL of the book on Project Gutenberg
-            format_type: Either "text" for Plain TEXT UTF-8 or "epub" for EPUB format
-
-        Returns:
-            Content of the downloaded book or None if download fails
-        """
-        try:
-            logger.info(f"Downloading book from: {book_url}")
-
-            # Get the book page
-            response = self.session.get(book_url, timeout=10)
-            response.raise_for_status()
-
-            # Extract download links from the page
-            download_url = self._extract_download_url(response.text, format_type)
-
-            if not download_url:
-                logger.warning(f"Could not find {format_type} download link for {book_url}")
-                return None
-
-            # Ensure URL is absolute
-            if not download_url.startswith('http'):
-                download_url = urljoin(self.GUTENBERG_URL, download_url)
-
-            logger.info(f"Downloading from: {download_url}")
-
-            # Download the actual book file
-            response = self.session.get(download_url, timeout=30)
-            response.raise_for_status()
-
-            logger.info("Book downloaded successfully")
-            return response.text if format_type == "text" else response.content
-
-        except requests.RequestException as e:
-            logger.error(f"Error downloading book: {e}")
-            return None
-        except Exception as e:
-            logger.error(f"Unexpected error: {e}")
-            return None
-
-    def _extract_download_url(self, page_html: str, format_type: str) -> Optional[str]:
-        """
-        Extract the download URL for the specified format from book page HTML.
-
-        Args:
-            page_html: HTML content of the book page
-            format_type: "text" or "epub"
-
-        Returns:
-            Download URL or None if not found
-        """
-        try:
-            if LXML_SUPPORT:
-                tree = html.fromstring(page_html)
-
-                if format_type.lower() == "text":
-                    # Look for UTF-8 plain text link
-                    links = tree.xpath('//a[contains(@href, "cache") and contains(@href, ".txt.utf-8")]/@href')
-                    if links:
-                        return links[0]
-                elif format_type.lower() == "epub":
-                    # Look for EPUB link
-                    links = tree.xpath('//a[contains(@href, ".epub.images") or contains(@href, ".epub")]/@href')
-                    if links:
-                        return links[0]
-            else:
-                # Fallback: use regex if lxml not available
-                if format_type.lower() == "text":
-                    match = re.search(r'href="([^"]*\.txt\.utf-8[^"]*)"', page_html)
-                    if match:
-                        return match.group(1)
-                elif format_type.lower() == "epub":
-                    match = re.search(r'href="([^"]*\.epub[^"]*)"', page_html)
-                    if match:
-                        return match.group(1)
-
-            return None
-        except Exception as e:
-            logger.error(f"Error extracting download URL: {e}")
-            return None
-
-    def parse_text_book(self, content: str) -> Dict[str, any]:
-        """
-        Parse a plain text book and extract title, chapters, and content.
-
-        Args:
-            content: Plain text content of the book
-
-        Returns:
-            Dictionary with title, chapters, and cleaned text
-        """
-        try:
-            # Remove Project Gutenberg header and footer
-            cleaned = self._remove_gutenberg_boilerplate(content)
-
-            # Extract title (first non-empty line or from metadata)
-            title = self._extract_title(cleaned)
-
-            # Split into chapters
-            chapters = self._extract_chapters(cleaned)
-
-            # Clean content
-            main_text = self._clean_text(cleaned)
-
-            return {
-                'title': title,
-                'chapters': chapters,
-                'main_text': main_text,
-                'format': 'text',
-                'source': 'Project Gutenberg'
-            }
-        except Exception as e:
-            logger.error(f"Error parsing text book: {e}")
-            return None
-
-    def parse_epub_book(self, content: bytes) -> Optional[Dict[str, any]]:
-        """
-        Parse an EPUB book and extract title, chapters, and content.
-
-        Args:
-            content: EPUB file content (bytes)
-
-        Returns:
-            Dictionary with title, chapters, and cleaned text
-        """
-        if not EPUB_SUPPORT:
-            logger.error("EPUB support not available. Install ebooklib: pip install ebooklib")
-            return None
-
-        try:
-            # Save to temporary file for ebooklib
-            import tempfile
-            with tempfile.NamedTemporaryFile(suffix='.epub', delete=False) as tmp:
-                tmp.write(content)
-                tmp_path = tmp.name
-
-            try:
-                # Read EPUB
-                book = epub.read_epub(tmp_path)
-
-                # Extract title
-                title = book.get_metadata('DC', 'title')
-                if title:
-                    title = title[0][0] if isinstance(title, list) else title
-                else:
-                    title = "Untitled"
-
-                # Extract chapters and content
-                chapters = []
-                main_text_parts = []
-
-                for item in book.get_items():
-                    if item.get_type() == epub.ITEM_DOCUMENT:
-                        text = self._extract_text_from_epub_item(item)
-                        if text.strip():
-                            main_text_parts.append(text)
-                            # Simple chapter detection
-                            if re.match(r'^(Chapter|CHAPTER|\d+)', text.strip()):
-                                chapters.append(text[:100])
-
-                main_text = '\n\n'.join(main_text_parts)
-                main_text = self._clean_text(main_text)
-
-                return {
-                    'title': title,
-                    'chapters': chapters,
-                    'main_text': main_text,
-                    'format': 'epub',
-                    'source': 'Project Gutenberg'
-                }
-            finally:
-                # Clean up temp file
-                os.unlink(tmp_path)
-
-        except Exception as e:
-            logger.error(f"Error parsing EPUB book: {e}")
-            return None
-
-    def _extract_text_from_epub_item(self, item) -> str:
-        """Extract text content from an EPUB item."""
-        try:
-            content = item.get_content().decode('utf-8', errors='ignore')
-            if LXML_SUPPORT:
-                tree = html.fromstring(content)
-                text = tree.text_content()
-            else:
-                # Simple HTML tag removal
-                text = re.sub(r'<[^>]+>', '', content)
-            return text
-        except Exception as e:
-            logger.warning(f"Error extracting text from EPUB item: {e}")
-            return ""
-
-    def _remove_gutenberg_boilerplate(self, content: str) -> str:
-        """Remove Project Gutenberg header and footer."""
-        # Remove header
-        for pattern in self.HEADER_PATTERNS:
-            content = re.sub(pattern, '', content, flags=re.IGNORECASE | re.DOTALL)
-
-        # Remove footer
-        for pattern in self.FOOTER_PATTERNS:
-            content = re.sub(pattern, '', content, flags=re.IGNORECASE | re.DOTALL)
-
-        return content
-
-    def _extract_title(self, content: str) -> str:
-        """Extract the book title from content."""
-        # Look for "Title:" at the beginning
-        match = re.search(r'^Title:\s*(.+?)(?:\nAuthor:|$)', content, re.MULTILINE)
-        if match:
-            return match.group(1).strip()
-
-        # Otherwise, use first non-empty line
-        for line in content.split('\n'):
-            line = line.strip()
-            if line and len(line) > 5 and len(line) < 200:
-                return line
-
-        return "Untitled"
-
-    def _extract_chapters(self, content: str) -> List[str]:
-        """Extract chapter titles from content."""
-        chapters = []
-
-        # Look for common chapter patterns
-        patterns = [
-            r'^(CHAPTER\s+\w+[:\.]?\s*.*)$',
-            r'^(Chapter\s+\d+[:\.]?\s*.*)$',
-            r'^(\d+\.\s+.+?)$',
-            r'^(Part\s+\w+[:\.]?\s*.*)$',
-        ]
-
-        for pattern in patterns:
-            for match in re.finditer(pattern, content, re.MULTILINE):
-                chapter = match.group(1).strip()
-                if chapter not in chapters:
-                    chapters.append(chapter)
-
-        return chapters[:20]  # Return first 20 chapters
-
-    def _clean_text(self, content: str) -> str:
-        """
-        Clean text content by removing extra whitespace and formatting artifacts.
-
-        Args:
-            content: Raw text content
-
-        Returns:
-            Cleaned text
-        """
-        # Remove multiple consecutive blank lines
-        content = re.sub(r'\n\n\n+', '\n\n', content)
-
-        # Remove lines that are just underscores/dashes/asterisks (decorative)
-        content = re.sub(r'^\s*[_\-*]+\s*$', '', content, flags=re.MULTILINE)
-
-        # Remove page break indicators
-        content = re.sub(r'\[\d+\]|\[Page\s+\d+\]', '', content)
-
-        # Clean up extra spaces within lines
-        content = re.sub(r' {2,}', ' ', content)
-
-        # Remove lines that are just whitespace
-        content = '\n'.join(line.rstrip() for line in content.split('\n'))
-
-        # Remove leading/trailing whitespace from the entire document
-        content = content.strip()
-
-        return content
-
-    def process_books(self, book_urls: List[str], format_type: str = "text",
-                      output_dir: str = "./processed_books") -> List[Dict]:
-        """
-        Download and process multiple books.
-
-        Args:
-            book_urls: List of Project Gutenberg book URLs
-            format_type: "text" or "epub"
-            output_dir: Directory to save processed books
-
-        Returns:
-            List of processed book data
-        """
-        output_path = Path(output_dir)
-        output_path.mkdir(parents=True, exist_ok=True)
-
-        results = []
-
-        for url in book_urls:
-            logger.info(f"Processing: {url}")
-
-            # Download book
-            content = self.download_book(url, format_type)
-            if not content:
-                logger.warning(f"Skipping {url} - download failed")
-                continue
-
-            # Parse book
-            if format_type.lower() == "text":
-                book_data = self.parse_text_book(content)
-            elif format_type.lower() == "epub":
-                book_data = self.parse_epub_book(content)
-            else:
-                logger.error(f"Unsupported format: {format_type}")
-                continue
-
-            if not book_data:
-                logger.warning(f"Skipping {url} - parsing failed")
-                continue
-
-            # Save processed book
-            safe_filename = re.sub(r'[^\w\s-]', '', book_data['title']).replace(' ', '_')[:50]
-            output_file = output_path / f"{safe_filename}.json"
-
-            try:
-                with open(output_file, 'w', encoding='utf-8') as f:
-                    json.dump(book_data, f, indent=2, ensure_ascii=False)
-                logger.info(f"Saved to: {output_file}")
-                results.append({
-                    'url': url,
-                    'title': book_data['title'],
-                    'file': str(output_file),
-                    'status': 'success'
-                })
-            except Exception as e:
-                logger.error(f"Error saving book: {e}")
-                results.append({
-                    'url': url,
-                    'status': 'error',
-                    'error': str(e)
-                })
-
-        return results
-
-
-def main():
-    """Example usage of the downloader."""
-    downloader = GutenbergDownloader()
-
-    # Example: Download "Alice's Adventures in Wonderland"
-    books = [
-        "https://www.gutenberg.org/ebooks/11",  # Alice in Wonderland
-    ]
-
-    results = downloader.process_books(books, format_type="text")
-
-    for result in results:
-        print(f"\n{result}")
-
-
-if __name__ == "__main__":
-    main()

tech_stack.md

@@ -1,219 +0,0 @@
-# Tech Stack
-
-## Architecture (Hackathon-Simple)
-
-Single Python file Gradio app. Everything runs in one process on a GPU-enabled HF Space.
-
-```
-┌─────────────────────────────────────────────────┐
-│  Hugging Face Space (GPU: T4 or A10G)           │
-│                                                 │
-│  app.py (Gradio + gr.Server)                    │
-│    ├── UI: Stitch-styled tabs/cards             │
-│    ├── QWEN-TTS-0.6B (voice clone + chunks)     │
-│    ├── Whisper-small (ASR for child questions)  │
-│    └── Qwen2.5-3B-Instruct (story Q&A)          │
-│                                                 │
-│  stories/ (3–5 .txt files, public domain)       │
-└─────────────────────────────────────────────────┘
-```
-
-No database. No external storage. No external LLM API. Stories are flat files. Audio is generated as interruptible chunks, then cached in the session for replay and resume.
-
-**VRAM Budget (T4 — 16 GB):**
-
-| Component | Estimated VRAM | Notes |
-|---|---|---|
-| QWEN-TTS-0.6B | ~1.2 GB | Always loaded |
-| Qwen2.5-3B-Instruct (4-bit) | ~2 GB | Always loaded |
-| Whisper-small | ~1 GB | Loaded on demand |
-| Gradio + PyTorch overhead | ~1–2 GB | Runtime |
-| **Total** | **~5–6 GB** | ~10 GB headroom for KV cache and activations |
-
-**Concurrency:** Single-process Gradio serializes concurrent users. The hackathon demo is single-user. For multi-user, consider Gradio queue or separate worker processes.
-
----
-
-## 1. Front-End
-
-| Choice | Why |
-|---|---|
-| Gradio 5.x | Zero frontend code, instant HF Space deploy |
-| `gr.Server` | Custom CSS/JS for Stitch-style polish (animations, palette, layout) |
-| `gr.Audio` | Record/upload parent voice sample |
-| `gr.Dropdown` / `gr.Gallery` | Story selection with cover art |
-| `gr.Audio` (output) | Playback of streamed story chunks / Q&A answer |
-| `gr.Textbox` + `gr.Audio` (input) | Child question via text or voice |
-| Play/Pause/Ask buttons | Manual interruption and resume without open-mic barge-in |
-
-**UI Tabs:**
-1. **🎤 Clone Voice** — record/upload 15–30s, preview clone
-2. **📖 Listen** — pick story, hear streamed chunks in cloned voice
-3. **❓ Ask** — pause narration, ask about the story, hear answer, resume
-
----
-
-## 2. Voice Model (QWEN-TTS-0.6B)
-
-| Aspect | Detail |
-|---|---|
-| Model | `Qwen/Qwen-TTS-0.6B` from Hugging Face Hub |
-| Size | 0.6B params — fits comfortably on T4 (16GB VRAM) |
-| Capability | Zero-shot voice cloning + TTS from text chunks |
-| Input | Reference audio (≥5s) + target text |
-| Output | WAV audio in cloned voice (24 kHz, 16-bit, mono) |
-| Latency | ~3–5s for a paragraph on T4 |
-| Optimization | Cache the voice representation after recording; generate story audio in interruptible paragraph chunks |
-
----
-
-## 3. ASR (Child Voice Input)
-
-| Choice | Detail |
-|---|---|
-| Model | Whisper-small checkpoint via Transformers (local, 244M params) |
-| Why | Fast, accurate for short child utterances; fits in GPU alongside TTS |
-| Load strategy | Load only when the Ask tab receives audio; text questions bypass ASR |
-| Fallback | Whisper-tiny/base or browser transcription if GPU memory or latency is tight |
-
----
-
-## 4. Q&A (Story Comprehension)
-
-| Choice | Detail |
-|---|---|
-| Model | `Qwen/Qwen2.5-3B-Instruct` |
-| Why | Strong small-model instruction following with lower latency and VRAM pressure than an 8B-class model |
-| Method | Current story position + relevant story passages + strict answer-from-story instruction + child question → short answer |
-| Retrieval | TF-IDF cosine similarity between the child's question and each story paragraph; return the top-2 paragraphs as context. Full-story prompt is the fallback when retrieval scores are low. |
-| Output cap | 1–2 child-friendly sentences, typically 40–80 new tokens |
-| Runtime note | Use 4-bit/8-bit loading on T4; use bf16 or 8-bit on A10G for more headroom |
-
----
-
-## 5. Stories (Content)
-
-10 public domain children's stories stored as `.txt` in `stories/`, sourced from [Project Gutenberg](https://www.gutenberg.org/) via the `story_downloader/` pipeline:
-
-| Story | Words | Author/Tradition |
-|---|---|---|
-| The Tale of Peter Rabbit | 948 | Beatrix Potter |
-| The Tale of Benjamin Bunny | 1,118 | Beatrix Potter |
-| The Tale of Jemima Puddle-Duck | 1,245 | Beatrix Potter |
-| The Tale of Tom Kitten | 691 | Beatrix Potter |
-| The History of Tom Thumb | 2,912 | Traditional |
-| The Story of the Three Little Pigs | 956 | Traditional |
-| The Little Red Hen | 1,295 | Traditional |
-| The Little Gingerbread Man | 1,823 | Traditional |
-| The Sleeping Beauty | 1,783 | Traditional |
-| The Adventures of Puss in Boots | 503 | Traditional (verse) |
-
-Each file: title on line 1, blank line, then story prose — ready for direct TTS chunking. No metadata DB needed.
-
-**Story Pipeline (`story_downloader/`):**
-- `gutenberg_downloader.py` — reusable downloader/parser for Project Gutenberg texts
-- `download_stories.py` — fetches 10 specific children's stories by Gutenberg ID
-- `clean_stories.py` — strips Gutenberg headers/footers, illustration tags, and metadata for TTS-clean output
-
----
-
-## 6. Deployment
-
-| What | How |
-|---|---|
-| Platform | Hugging Face Spaces |
-| SDK | Gradio |
-| Hardware | T4 with quantized Qwen for the budget path; A10G for lower risk live demos |
-| Deploy | `git push` to HF Space repo |
-| Secrets | None for LLM inference; `HF_TOKEN` only if any selected model requires gated access |
-| Domain | `huggingface.co/spaces/{user}/readbookmom` |
-
----
-
-## 7. Latency Plan
-
-| Flow | Target | Implementation |
-|---|---|---|
-| Voice setup | One-time after recording | Compute and cache the voice representation before story generation. |
-| Story narration start | First streamed chunk in ≤ 5s | Split the story into paragraph chunks; synthesize and play the first chunk first. |
-| Narration interruption | Pause in ≤ 500ms after Ask tap | Stop playback, preserve current chunk index, and cancel or deprioritize queued narration jobs. |
-| Q&A interruption loop | Spoken answer starts in ≤ 8s | Use current story position, retrieve relevant passages, cap answer length, then synthesize the final answer. |
-| Story resume | ≤ 1s when next chunk is cached | Resume from the paused chunk or the next queued chunk after the answer finishes. |
-| Story replay | Immediate after first generation | Cache generated audio by voice session and story ID. |
-| Child audio transcription | 1–2s target | Load ASR only for audio questions; prefer lighter ASR fallback for demo mode. |
-| Q&A text answer | 1–3s target | Send only relevant story passages to Qwen and cap output tokens. |
-| Spoken Q&A answer | ≤ 8s total target | Synthesize only the final short answer, not intermediate reasoning or context. |
-
-## 8. Interaction State
-
-| State | Meaning | Key Data |
-|---|---|---|
-| `playing` | Story chunk is currently playing. | `story_id`, `voice_session_id`, `current_chunk_index` |
-| `paused` | Playback is paused by user action. | Current chunk, elapsed position if available |
-| `asking` | Narration is interrupted while the child asks a question. | Current chunk, relevant passages, pending ASR input |
-| `answering` | Qwen answer or answer TTS is being generated. | Question text, short answer, answer audio path |
-| `resuming` | Answer finished and story playback is restarting. | Resume chunk index, cached next chunk |
-| `finished` | Story narration completed. | Cached full-story audio |
-
-**Legal transitions:**
-
-```
-playing → paused → playing
-playing → asking → answering → resuming → playing
-playing → finished
-paused  → asking  → answering → resuming → playing
-asking  → asking  (child asks a follow-up before answer starts)
-```
-
-All other transitions are illegal. The UI should disable buttons that would trigger an illegal transition.
-
----
-
-## 9. Local Dev
-
-```bash
-pip install gradio transformers torch accelerate bitsandbytes soundfile numpy
-python app.py
-# → http://localhost:7860
-```
-
-No Docker, no DB, no infra setup.
-
----
-
-## 10. Dependencies
-
-```
-gradio>=5.0
-transformers
-torch
-accelerate
-bitsandbytes
-soundfile
-numpy
-```
-
----
-
-## 11. Google Stitch UI Customization (via gr.Server)
-
-`gr.Server` injects custom HTML/CSS/JS to achieve Stitch-quality polish:
-
-- **Custom CSS**: Rounded cards, warm color palette (#FFB347 accent, #FFF8E7 background), playful fonts (Nunito/Fredoka)
-- **Micro-animations**: Fade-in on story cards, pulse on recording button, waveform visualization
-- **Layout overrides**: Full-bleed hero on clone tab, grid gallery for stories
-- **Custom favicon + title**: Branded for demo presentation
-
-All in a `static/` folder loaded by gr.Server mount.
-
----
-
-## 12. Review Notes
-
-| Area | Critique | Upgrade |
-|---|---|---|
-| Privacy | Using an external Q&A API would undermine the local-inference claim. | Qwen2.5-3B-Instruct keeps questions, story text, and generated answers inside the Space runtime. |
-| GPU fit | QWEN-TTS-0.6B, Whisper-small, and a 3B-class LLM are a more realistic fit for a single Space than an 8B-class LLM, but running all three hot can still pressure T4. | Quantize Qwen on T4, use A10G for demo headroom, cache voice/story artifacts, and load ASR only when the Ask tab receives audio. |
-| Latency | Full-story generation and spoken Q&A can feel slow if every step waits for complete outputs. | Use interruptible paragraph chunks, cache full narration, retrieve only relevant passages, and synthesize only short final answers. |
-| Interaction | Streaming without cancellation can still feel rigid if the child must wait for a chunk to finish. | Add explicit playback state, Ask interruption, queued job cancellation/deprioritization, and resume from the saved chunk. |
-| Dependencies | External LLM SDKs and API secrets are no longer aligned with the model choice. | Use local inference dependencies and optional HF authentication only. |

test_modules/app_supertonic_tts_demo.py

@@ -1,243 +0,0 @@
-"""
-Supertonic TTS Gradio Demo — concurrent chunk streaming with playback sync
-Splits text into statements, synthesizes in a background thread, streams
-audio chunk-by-chunk.  A JS timeupdate listener tracks audio.currentTime
-to bold exactly the chunk currently playing in the browser.
-
-Usage:
-  python app.py
-"""
-import json
-import logging
-import queue
-import re
-import threading
-from pathlib import Path
-
-import gradio as gr
-import numpy as np
-
-from supertonic import TTS, AVAILABLE_LANGUAGES
-
-logger = logging.getLogger(__name__)
-
-CLONED_VOICE_JSON = Path(__file__).resolve().parent / "recorded_voice_supertonic-3.json"
-CLONED_VOICE_LABEL = "Custom (recorded_voice_supertonic-3.json)"
-
-print("Loading Supertonic TTS model...")
-tts = TTS(auto_download=True)
-
-builtin_voices = tts.voice_style_names  # M1-M5, F1-F5
-all_voices = ([CLONED_VOICE_LABEL] + builtin_voices) if CLONED_VOICE_JSON.exists() else builtin_voices
-
-_SENTENCE_SPLIT_RE = re.compile(r'(?<=[.!?;])\s+')
-_SENTINEL = object()
-
-# JavaScript injected once at page load.
-# Watches for changes to the hidden timing component, then attaches a
-# timeupdate listener that bolds whichever .chunk-text span is currently
-# playing based on audio.currentTime.
-_SYNC_JS = """
-() => {
-    function attachAudioSync(chunks) {
-        // Find the streaming audio element — Gradio wraps it inside a
-        // data-testid="audio" block; fall back to first <audio> on the page.
-        const container = document.querySelector('[data-testid="audio"]') ||
-                          document.querySelector('.audio-container');
-        const audio = container ? container.querySelector('audio')
-                                : document.querySelector('audio');
-        if (!audio) {
-            // Audio element not yet in DOM — retry shortly.
-            setTimeout(() => attachAudioSync(chunks), 150);
-            return;
-        }
-
-        // Remove any previous listener we registered.
-        if (audio._ttsSyncHandler) {
-            audio.removeEventListener('timeupdate', audio._ttsSyncHandler);
-        }
-
-        audio._ttsSyncHandler = () => {
-            const t = audio.currentTime;
-            document.querySelectorAll('.chunk-item').forEach((item, i) => {
-                const textEl = item.querySelector('.chunk-text');
-                if (!textEl || i >= chunks.length) return;
-                const active = t >= chunks[i].start && t < chunks[i].end;
-                textEl.style.fontWeight = active ? '700' : 'normal';
-            });
-        };
-
-        audio.addEventListener('timeupdate', audio._ttsSyncHandler);
-    }
-
-    // Observe the hidden timing textbox for value changes.
-    const observer = new MutationObserver(() => {
-        const box = document.querySelector('#tts-timing-box textarea');
-        if (!box || !box.value) return;
-        let chunks;
-        try { chunks = JSON.parse(box.value); } catch(e) { return; }
-        if (chunks.length) attachAudioSync(chunks);
-    });
-    observer.observe(document.body, { childList: true, subtree: true, characterData: true });
-}
-"""
-
-
-def split_into_statements(text: str) -> list[str]:
-    parts = _SENTENCE_SPLIT_RE.split(text.strip())
-    return [p.strip() for p in parts if p.strip()]
-
-
-def _chunks_html(statements: list[str], playing_idx: int, generating_idx: int) -> str:
-    rows = []
-    for i, stmt in enumerate(statements):
-        if i < playing_idx:
-            icon, color = "✅", "#16a34a"
-        elif i == playing_idx:
-            icon, color = "▶️", "#2563eb"
-        elif i == generating_idx:
-            icon, color = "⏳", "#d97706"
-        else:
-            icon, color = "○", "#9ca3af"
-
-        rows.append(
-            f'<div class="chunk-item" style="display:flex;gap:8px;padding:3px 0;">'
-            f'<span style="color:{color};min-width:18px;font-size:13px;">{icon}</span>'
-            f'<span class="chunk-text" style="font-size:13px;color:#374151;line-height:1.4;">{stmt}</span>'
-            f'</div>'
-        )
-    return '<div style="margin-top:8px;">' + "".join(rows) + "</div>"
-
-
-def generate_audio(text: str, voice_name: str, language: str, speed: float, steps: int):
-    text = (text or "").strip()
-    if not text:
-        yield gr.update(), "Please enter some text.", "", "[]"
-        return
-
-    try:
-        style = (
-            tts.get_voice_style_from_path(CLONED_VOICE_JSON)
-            if voice_name == CLONED_VOICE_LABEL
-            else tts.get_voice_style(voice_name)
-        )
-
-        statements = split_into_statements(text) or [text]
-        n = len(statements)
-
-        chunk_q: queue.Queue = queue.Queue(maxsize=2)
-
-        def _worker():
-            for i, stmt in enumerate(statements):
-                try:
-                    wav, _ = tts.synthesize(
-                        stmt,
-                        voice_style=style,
-                        lang=language,
-                        speed=speed,
-                        total_steps=int(steps),
-                    )
-                    chunk_q.put((i, wav.squeeze()))
-                except Exception as exc:
-                    chunk_q.put((i, exc))
-                    return
-            chunk_q.put(_SENTINEL)
-
-        worker = threading.Thread(target=_worker, daemon=True)
-        worker.start()
-
-        yield gr.update(), f"Generating chunk 1/{n}…", _chunks_html(statements, -1, 0), "[]"
-
-        timing: list[dict] = []   # [{start, end}, …] — grows as chunks arrive
-        cumulative = 0.0
-
-        while True:
-            item = chunk_q.get()
-            if item is _SENTINEL:
-                break
-
-            i, payload = item
-            if isinstance(payload, Exception):
-                yield gr.update(), f"Generation failed on chunk {i + 1}: {payload}", "", json.dumps(timing)
-                return
-
-            wav = payload
-            dur = len(wav) / tts.sample_rate
-            timing.append({"start": round(cumulative, 4), "end": round(cumulative + dur, 4)})
-            cumulative += dur
-
-            next_gen = i + 1 if i + 1 < n else -1
-            status = (
-                f"Playing {i + 1}/{n}, generating {next_gen + 1}/{n}…"
-                if next_gen >= 0
-                else f"Playing {i + 1}/{n}"
-            )
-
-            yield (
-                (tts.sample_rate, wav),
-                status,
-                _chunks_html(statements, i, next_gen),
-                json.dumps(timing),   # JS picks this up via MutationObserver
-            )
-
-        worker.join()
-        total_dur = cumulative
-        yield (
-            gr.update(),
-            f"Done — {n} chunks, {total_dur:.1f}s total",
-            _chunks_html(statements, n, -1),
-            json.dumps(timing),
-        )
-
-    except Exception as e:
-        logger.exception("Audio generation failed")
-        yield gr.update(), f"Generation failed: {type(e).__name__}: {e}", "", "[]"
-
-
-with gr.Blocks(title="Supertonic TTS Demo", js=_SYNC_JS) as demo:
-    gr.Markdown(f"# Supertonic TTS Demo\n**Model:** `supertonic-3` · **Voices:** {len(all_voices)}")
-
-    with gr.Row():
-        with gr.Column(scale=2):
-            text_input = gr.Textbox(
-                label="Text",
-                placeholder="Enter text to synthesize…",
-                lines=5,
-            )
-
-            with gr.Row():
-                lang_input = gr.Dropdown(
-                    label="Language",
-                    choices=AVAILABLE_LANGUAGES,
-                    value="en",
-                    interactive=True,
-                )
-                voice_input = gr.Dropdown(
-                    label="Voice Style",
-                    choices=all_voices,
-                    value=all_voices[0],
-                    interactive=True,
-                )
-
-            with gr.Row():
-                speed_input = gr.Slider(label="Speed", minimum=0.7, maximum=2.0, value=1.05, step=0.05)
-                steps_input = gr.Slider(label="Quality Steps", minimum=1, maximum=20, value=8, step=1)
-
-            play_btn = gr.Button("Play", variant="primary", size="lg")
-
-        with gr.Column(scale=3):
-            # streaming=True: each yielded chunk is appended to the playback buffer
-            audio_out = gr.Audio(label="Generated Speech", type="numpy", autoplay=True, streaming=True)
-            status_out = gr.Textbox(label="Status", lines=1, interactive=False)
-            chunks_out = gr.HTML()
-            # Hidden component — carries [{start, end}] timing per chunk to JS
-            timing_out = gr.Textbox(visible=False, elem_id="tts-timing-box")
-
-    play_btn.click(
-        generate_audio,
-        inputs=[text_input, voice_input, lang_input, speed_input, steps_input],
-        outputs=[audio_out, status_out, chunks_out, timing_out],
-    )
-
-if __name__ == "__main__":
-    demo.queue().launch()

test_modules/supertonic_clone_demo.py

@@ -1,34 +0,0 @@
-from supertonic import TTS
-from supertonic import pipeline
-import numpy as np
-from pathlib import Path
-
-tts = TTS(auto_download=True)
-
-# Load a locally downloaded custom voice style JSON.
-json_path = Path(__file__).resolve().parent / "recorded_voice_supertonic-3.json"
-style = pipeline.load_voice_style_from_json_file(str(json_path))
-
-# text = "A gentle breeze moved through the open window while everyone listened to the story."
-# text = "Hello, Bay Area K group Vibe coding members. This is generated by Supertonic model on my local machine"
-# text = "To clarify if this model is locally inferenced, I turned off wifi and generated this audio"
-# text = "Testing my clone model voice TTS in English"
-text = """
-Long before the advent of the printing press or the digital screen, humanity’s fundamental drive to communicate birthed the earliest systems of recorded thought.
-It began with pictographs etched into the cool, unyielding stone of ancient caves, where early storytellers captured the essence of their daily lives, spiritual beliefs, and conquests.
-These simple drawings were not mere decoration;
-they were the very first seeds of human collaboration, allowing knowledge to transcend the boundaries of a single lifetime.
-As human societies grew in complexity, so did their methods of encoding information.
-The transition from crude cave art to structured written systems marked a monumental leap in cognitive evolution.
-In the fertile crescent of Mesopotamia, the need to track agricultural surplus and administrative records led to the development of cuneiform, a system of wedge-shaped marks pressed into damp clay tablets.
-This was the dawn of history—the moment when human thought could be permanently preserved, retrieved, and scrutinized by others.
-"""
-wav, duration = tts.synthesize(text, voice_style=style, lang="en")
-
-# text = "한국어 보이스 클로닝 테스트. 하나둘셋 하나둘셋. 동해물과 백두산이 마르고 닳도록"
-# wav, duration = tts.synthesize(text, voice_style=style, lang="ko")
-
-
-tts.save_audio(wav, "clone_output_04.wav")
-duration_sec = float(np.asarray(duration).reshape(-1)[0])
-print(f"Generated {duration_sec:.2f}s of audio")

tts.py

@@ -1,62 +0,0 @@
-"""
-TTS module — wraps Supertonic TTS with sentence-level chunking and
-background-threaded streaming generation.
-"""
-import logging
-import queue
-import re
-import threading
-
-logger = logging.getLogger(__name__)
-
-_SENTENCE_RE = re.compile(r'(?<=[.!?;])\s+')
-_SENTINEL = object()
-
-_tts_instance = None
-
-
-def get_tts():
-    global _tts_instance
-    if _tts_instance is None:
-        from supertonic import TTS
-        logger.info("Loading Supertonic TTS model…")
-        _tts_instance = TTS(auto_download=True)
-    return _tts_instance
-
-
-def split_into_chunks(text: str) -> list[str]:
-    """Split text into sentence-level chunks suitable for TTS streaming."""
-    parts = _SENTENCE_RE.split(text.strip())
-    return [p.strip() for p in parts if p.strip()]
-
-
-def generate_audio_stream(chunks: list[str], voice_name: str = "F1"):
-    """
-    Generator: synthesizes chunks in a background thread (maxsize=2 buffer).
-    Yields (sample_rate, wav_array, chunk_idx, total_chunks, error_msg).
-    wav_array is None on error.
-    """
-    tts = get_tts()
-    style = tts.get_voice_style(voice_name)
-    n = len(chunks)
-    chunk_q: queue.Queue = queue.Queue(maxsize=2)
-
-    def _worker():
-        for i, stmt in enumerate(chunks):
-            try:
-                wav, _ = tts.synthesize(stmt, voice_style=style)
-                chunk_q.put((i, wav.squeeze(), None))
-            except Exception as exc:
-                logger.exception("TTS synthesis failed on chunk %d", i)
-                chunk_q.put((i, None, str(exc)))
-                return
-        chunk_q.put(_SENTINEL)
-
-    threading.Thread(target=_worker, daemon=True).start()
-
-    while True:
-        item = chunk_q.get()
-        if item is _SENTINEL:
-            break
-        i, wav, err = item
-        yield tts.sample_rate, wav, i, n, err