Readme.md

metadata

title: WikiTales
emoji: 📚
colorFrom: indigo
colorTo: pink
sdk: streamlit
sdk_version: 1.35.0
app_file: app.py
pinned: false

📖 WikiTales – Interactive Historical Storybooks

WikiTales is an open-source, story-driven web app that transforms raw historical data from Wikimedia projects into immersive, engaging storybook-style narratives. Built with Python and Streamlit, it’s designed to help learners explore the past like never before.

---

Team Members

• Rishi Palavarapu
• Harsha Ambati
• Rishitha Reddy
• Yaswanth Ambati

---

🚀 Overview

WikiTales bridges storytelling and research by compiling content from Wikimedia public APIs such as Wikipedia, Wikiquote, Wikidata, Wikisource, Wikibooks, and more. It generates narrative summaries, trivia facts, quotes, timelines, and glossary definitions based on user-entered topics.

---

🔍 Key Features

• 🧠 AI-generated Story Narratives based on historical events and figures
• 🎭 Narrator Styles: Choose between historian, eyewitness, journalist, AI assistant, etc.
• 🧾 Dynamic Timelines of important events
• 💬 Quotes & Primary Sources from Wikiquote and Wikisource
• 🧠 “Did You Know?” Facts from Wikidata
• 📚 Wikibooks Sidebar for extended learning material
• 📸 Image Carousel using Wikimedia Commons

---

🛠️ Built With

• Frontend & UI: Streamlit
• Language: Python 3.10+
• Data Sources:
  • Wikipedia API
  • Wikidata API
  • Wikibooks API
  • Wikiquote API
  • Wiktionary API
  • Wikisource API
  • Wikimedia Commons API

---

⚙️ How It Works

1. User enters a topic (e.g. World War II).
2. WikiTales fetches:
   • Summary from Wikipedia
   • Quotes from Wikiquote
   • Timeline from Wikidata
   • Definitions from Wiktionary
   • Images from Commons
   • Source documents from Wikisource
   • Related books from Wikibooks
3. Story is narrated using the selected voice and formatted as a storybook.
4. Additional enhancements include interactive glossary and image carousel.

---

🔧 Setup Instructions

To get started with this project, follow these steps:

# Clone the repository
git clone https://code.swecha.org/soai2025/soai-hackathon/team-titans.git

# Navigate to the project folder
cd team-titans

# (Optional but recommended) Create a virtual environment
python3 -m venv wikitales_venv
source wikitales_venv/bin/activate

# Install dependencies
pip install -r requirements.txt

# Run the app locally
streamlit run app.py

---

🚀 Deployment

This app is designed to be deployed on Hugging Face Spaces using the Streamlit template.

---

🗂️ Project Structure

WikiTales/
├── app.py                      # Main Streamlit app
├── requirements.txt            # Python dependencies
├── README.md                   # Project overview and setup
├── story_engine/               # All logic modules for fetching and generating story content
│   ├── __init__.py
│   ├── wikipedia.py
│   ├── wikiquote.py
│   ├── wikisource.py
│   ├── commons.py
│   ├── wikidata.py
│   ├── wikibooks.py
│   ├── formatter.py
│   └── story_builder.py        # Core function to build story from APIs

📁 story_engine/ contains modular Python files to keep the logic clean and testable.