Spaces:
Configuration error
Configuration error
| 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](https://streamlit.io/) | |
| - **Language**: Python 3.10+ | |
| - **Data Sources**: | |
| - [Wikipedia API](https://en.wikipedia.org/w/api.php) | |
| - [Wikidata API](https://www.wikidata.org/w/api.php) | |
| - [Wikibooks API](https://en.wikibooks.org/w/api.php) | |
| - [Wikiquote API](https://en.wikiquote.org/w/api.php) | |
| - [Wiktionary API](https://en.wiktionary.org/w/api.php) | |
| - [Wikisource API](https://en.wikisource.org/w/api.php) | |
| - [Wikimedia Commons API](https://commons.wikimedia.org/w/api.php) | |
| --- | |
| ## ⚙️ 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: | |
| ```bash | |
| # 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](https://huggingface.co/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. |