Update README.md
Browse files
README.md
CHANGED
|
@@ -9,4 +9,47 @@ app_file: app.py
|
|
| 9 |
pinned: false
|
| 10 |
---
|
| 11 |
|
| 12 |
-
Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 9 |
pinned: false
|
| 10 |
---
|
| 11 |
|
| 12 |
+
Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
|
| 13 |
+
|
| 14 |
+
# 👁️📖 Storytelling Application
|
| 15 |
+
|
| 16 |
+
This app allows you to upload an image and receive a **magical children's story with narration**, all generated by AI.
|
| 17 |
+
|
| 18 |
+
---
|
| 19 |
+
|
| 20 |
+
## 🚀 What It Does
|
| 21 |
+
|
| 22 |
+
1. **Image → Caption**
|
| 23 |
+
Uses the BLIP model to describe the uploaded image.
|
| 24 |
+
|
| 25 |
+
2. **Caption → Story**
|
| 26 |
+
Generates a fun and creative story using `facebook/opt-350m`.
|
| 27 |
+
|
| 28 |
+
3. **Story → Audio**
|
| 29 |
+
Uses gTTS to create an English narration of the story.
|
| 30 |
+
|
| 31 |
+
---
|
| 32 |
+
|
| 33 |
+
## 🧠 Powered by
|
| 34 |
+
|
| 35 |
+
- `Salesforce/blip-image-captioning-base` – Image Captioning
|
| 36 |
+
- `facebook/opt-350m` – Text Generation
|
| 37 |
+
- `gTTS` – Text to Speech
|
| 38 |
+
- `Streamlit` – UI Framework
|
| 39 |
+
|
| 40 |
+
---
|
| 41 |
+
|
| 42 |
+
## 📌 How to Use
|
| 43 |
+
|
| 44 |
+
- Click the “Upload Image” button
|
| 45 |
+
- Wait for the app to generate:
|
| 46 |
+
- A description of the image
|
| 47 |
+
- A story based on the description
|
| 48 |
+
- An audio narration of the story
|
| 49 |
+
- Listen and download your AI-generated fairytale 🎧
|
| 50 |
+
|
| 51 |
+
---
|
| 52 |
+
|
| 53 |
+
## 🧑💻 Author
|
| 54 |
+
|
| 55 |
+
Made by **Eason Liu**
|