---
title: Storytelling Application
emoji: 👁
colorFrom: indigo
colorTo: red
sdk: streamlit
sdk_version: 1.42.2
app_file: app.py
pinned: false
---

Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference

# 👁️📖 Storytelling Application

This app allows you to upload an image and receive a **magical children's story with narration**, all generated by AI.

---

## 🚀 What It Does

1. **Image → Caption**  
   Uses the BLIP model to describe the uploaded image.

2. **Caption → Story**  
   Generates a fun and creative story using `facebook/opt-350m`.

3. **Story → Audio**  
   Uses gTTS to create an English narration of the story.

---

## 🧠 Powered by

- `Salesforce/blip-image-captioning-base` – Image Captioning
- `facebook/opt-350m` – Text Generation
- `gTTS` – Text to Speech
- `Streamlit` – UI Framework

---

## 📌 How to Use

- Click the “Upload Image” button
- Wait for the app to generate:
  - A description of the image
  - A story based on the description
  - An audio narration of the story
- Listen and download your AI-generated fairytale 🎧

---

## 🧑‍💻 Author

Made by **Eason Liu**