Update docs to reflect story_downloader pipeline and 10-story corpus

- README.md: add story_downloader to project structure, add story table, update count
- mission.md: update scope from 3-5 to 10 stories, note Gutenberg source
- sprint.md: mark repo setup and story tasks done, update file structure with actual stories
- tech_stack.md: replace placeholder story list with actual 10 stories and pipeline docs
- Remove old Three_LIttle_Pigs.txt reference file (replaced by proper cleaned version)

README.md

@@ -38,7 +38,7 @@ Built for the Hugging Face Hackathon. Runs entirely on local models inside a Gra
 
 - **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:** 3–5 public domain `.txt` files
+- **Stories:** 10 public domain `.txt` files (downloaded and cleaned from Project Gutenberg)
 - **Storage:** In-memory session cache (no database)
 
 ## Quick Start (Local Dev)
@@ -56,7 +56,11 @@ python app.py
 ```
 ├── app.py                  # Main Gradio app
 ├── requirements.txt        # Python deps
-├── stories/                # Public domain story texts
+├── 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
@@ -65,6 +69,23 @@ python app.py
 └── 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.

mission.md

@@ -56,7 +56,7 @@ A parent at a laptop who records their voice, picks a short story, and shows the
 
 **In scope:**
 - Upload/record parent voice sample (15–30s)
-- Select from 3–5 pre-loaded short stories (public domain)
+- 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

sprint.md

@@ -11,10 +11,10 @@ Ship a public Hugging Face Space: parent clones voice → story streams in that
 
 | # | Task | Time | Done |
 |---|---|---|---|
-| 1 | Set up repo: `app.py`, `requirements.txt`, `stories/` | 30m | ☐ |
+| 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 3 short stories as `.txt` files (public domain) | 30m | ☐ |
+| 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.
@@ -92,10 +92,21 @@ VoiceClone/
 ├── app.py                  # Main Gradio app (all logic)
 ├── requirements.txt        # Python deps
 ├── README.md              # HF Space description
-├── stories/
-│   ├── three_bears.txt
-│   ├── tortoise_hare.txt
-│   └── little_red_hen.txt
+├── 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

stories/Three_LIttle_Pigs.txt

@@ -1,117 +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.
-

tech_stack.md

@@ -93,14 +93,27 @@ No database. No external storage. No external LLM API. Stories are flat files. A
 
 ## 5. Stories (Content)
 
-3–5 public domain stories stored as `.txt` in `stories/`:
-- *The Three Bears*
-- *The Tortoise and the Hare*
-- *The Ugly Duckling*
-- *Goodnight Moon* (if public domain) or similar
-- *The Little Red Hen*
-
-Each file: title on line 1, text below. No metadata DB needed.
+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
 
 ---