Upload 4 files

Readme.md

@@ -0,0 +1,109 @@
+# 📚 WikiSage – All Wiki Resources for a Topic
+
+> 🔍 One Topic. All Wiki. Your Way.
+
+## Team Members
+- Rishi Palavarapu
+- Harsha Ambati
+- Rishitha Reddy
+- Yaswanth Ambati
+
+## 🧠 Overview
+
+**WikiSage** is a smart, educational app built for the WikiVerse Hackathon. It allows users to explore **comprehensive information about any topic** by aggregating and organizing resources from across Wikimedia projects like Wikipedia, Wikibooks, Wikiquote, Commons, Wikisource, and more — all in one place.
+
+---
+
+## 🎯 Problem Statement
+
+Millions of users rely on Wikimedia for learning, but navigating multiple platforms (Wikipedia, Wikibooks, Wikiquote, etc.) to gather full information on a single topic is **time-consuming and fragmented**.
+
+There is no unified platform that allows learners to:
+
+- Seamlessly explore all types of Wikimedia content (articles, books, quotes, images, source texts) on **one topic**
+- **Access diverse formats of learning content** (definitions, timelines, media, references)
+- Interact with this knowledge in a structured, multilingual, and accessible way
+
+---
+
+## 💡 Solution
+
+**WikiSage** solves this by:
+- Fetching content from multiple Wikimedia public APIs
+- Structuring them into an intuitive, topic-based interface
+- Providing features like multilingual support, content export, and related topic mapping
+
+---
+
+## 🚀 Features
+
+| Feature | Description |
+|--------|-------------|
+| 🔍 **Smart Topic Search** | User inputs a topic (e.g., "Quantum Physics", "Mahatma Gandhi") |
+| 📄 **Knowledge Summary** | Summary and detailed content from Wikipedia |
+| 📚 **In-Depth Books** | Structured reading material from Wikibooks |
+| 💬 **Famous Quotes** | Related quotes using Wikiquote |
+| 📜 **Primary Sources** | Historical documents from Wikisource |
+| 🖼️ **Media Gallery** | Relevant images from Commons |
+| 🧠 **Linked Topics Map** | Visual exploration of related topics via Wikidata |
+| 🌐 **Multilingual Mode** | Pulls topic info in different languages via Wikimedia APIs |
+| 📥 **Export Feature** | Download topic summary as PDF or Markdown |
+
+---
+
+## 🌐 APIs Used
+
+All APIs are strictly from the list approved in the [WikiVerse Hackathon Guidelines](#):
+
+| API | Purpose |
+|-----|---------|
+| Wikipedia (`en.wikipedia.org`) | Topic summaries & articles |
+| Wikibooks (`en.wikibooks.org`) | Educational book modules |
+| Wikisource (`en.wikisource.org`) | Primary documents |
+| Wikiquote (`en.wikiquote.org`) | Famous quotes |
+| Commons (`commons.wikimedia.org`) | Media assets (images, posters, etc.) |
+| Wiktionary (`en.wiktionary.org`) | Definitions and multilingual word meanings |
+| Wikidata (`www.wikidata.org`) | Related concepts and metadata |
+
+---
+
+## 🎯 Target Users
+
+- 📘 Students researching a subject  
+- 🧠 Self-learners exploring a new topic  
+- 👨‍🏫 Educators curating study content  
+- 📰 Content creators/fact-checkers  
+- 🌍 Anyone interested in structured, verified knowledge
+
+---
+
+## 🛠️ Tech Stack
+
+- **Frontend**: HTML, CSS, JavaScript / React (choose based on final implementation)  
+- **Backend**: Node.js / Python (for API integration & routing)  
+- **APIs**: RESTful calls to Wikimedia APIs  
+- **Hosting**: GitLab Pages / Local, Streamlit Cloud
+
+---
+
+## 📦 Project Structure
+| Hour | Phase                         | Tasks                                                                 |
+|------|-------------------------------|-----------------------------------------------------------------------|
+| 1    | *Ideation & Planning*       | Define app scope, identify APIs needed, finalize features, assign tasks |
+| 2    | *UI/UX & Architecture*      | Design layout, multilingual UI, API-client separation, wireframes     |
+| 3-5  | *Development Phase*         | Build Python backend (API wrappers for Wikipedia, Commons, Wikidata) <br> Build frontend with search UI + display views <br> Integrate AI model for summarization |
+| 6    | *Testing*                   | Test multilingual search, output display, and error handling          |
+| 7    | *Deployment & Refinement*   | Final fixes, improve UI, connect frontend to backend APIs             |
+| 8    | *Documentation & Pitch Prep*| Finalize README, prepare 5-minute demo and presentation             |
+
+
+---
+
+
+## 📖 How to Run Locally
+
+```bash
+git clone https://gitlab.com/your-team/wiki-sage.git
+cd wiki-sage
+npm install
+npm start

app.py

@@ -0,0 +1,121 @@
+# app.py
+import streamlit as st
+from streamlit.components.v1 import html
+from story_engine.story_builder import build_story
+
+st.markdown("""
+    <meta name="viewport" content="width=device-width, initial-scale=1">
+""", unsafe_allow_html=True)
+
+st.set_page_config(page_title="WikiTales", layout="centered")
+
+st.title("📖 WikiTales – Interactive Historical Storybooks")
+
+with st.container():
+    st.markdown("#### 🔍 Enter a historical figure or event:")
+    topic = st.text_input(
+        label="Search Topic",
+        placeholder="e.g., French Revolution",
+        key="search_box",
+        label_visibility="collapsed"
+    )
+
+    narrator = st.selectbox(
+        "Choose Narrator Voice",
+        options=["📚 Neutral Historian", "📰 Wartime Journalist", "👩‍🌾 Eyewitness", "🧙 Fictional Guide", "🤖 AI Assistant"],
+        index=0
+    )
+
+# -------------------------
+# Carousel Renderer Function
+# -------------------------
+
+def render_image_carousel(images):
+    if not images:
+        st.warning("No images found.")
+        return
+
+    # Build slides
+    slides = ""
+    for idx, img in enumerate(images):
+        slides += f"""
+        <div class="slide" id="slide-{idx}">
+          <img src="{img['url']}" alt="{img['title']}" />
+          <div class="caption">{img['title']}</div>
+        </div>"""
+
+    html_code = f"""
+    <style>
+      .carousel {{ position: relative; width: 100%; max-width: 700px; margin: auto; }}
+      .slide {{ display: none; text-align: center; }}
+      .slide img {{ max-width: 100%; max-height: 350px; border-radius: 8px; }}
+      .caption {{ color: #fff; background: rgba(0,0,0,0.5); padding: 0.5em; position: absolute; bottom: 8px; width: 100%; }}
+      .prev, .next {{
+        cursor: pointer;
+        position: absolute;
+        top: 50%;
+        width: auto;
+        margin-top: -22px;
+        padding: 16px;
+        color: white;
+        font-weight: bold;
+        font-size: 18px;
+        border-radius: 0 3px 3px 0;
+        user-select: none;
+      }}
+      .next {{ right: 0; border-radius: 3px 0 0 3px; }}
+    </style>
+
+    <div class="carousel">
+      {slides}
+      <a class="prev" onclick="changeSlide(-1)">&#10094;</a>
+      <a class="next" onclick="changeSlide(1)">&#10095;</a>
+    </div>
+
+    <script>
+      let currentSlide = 0;
+      const slides = document.getElementsByClassName('slide');
+      function showSlide(idx) {{
+        if (idx >= slides.length) currentSlide = 0;
+        else if (idx < 0) currentSlide = slides.length - 1;
+        else currentSlide = idx;
+        for (let i = 0; i < slides.length; i++) {{
+          slides[i].style.display = 'none';
+        }}
+        slides[currentSlide].style.display = 'block';
+      }}
+      function changeSlide(n) {{
+        showSlide(currentSlide + n);
+      }}
+      showSlide(0);
+    </script>
+    """
+
+    html(html_code, height=420)
+
+# -------------------------
+# Main Search + Display
+# -------------------------
+if topic:
+    with st.spinner(f"Generating story for '{topic}'..."):
+        story_data = build_story(topic, narrator)
+        story = story_data["story"]
+        images = story_data["images"]
+        wikibooks = story_data.get("wikibooks", [])  # ✅ added
+
+    if story:
+        render_image_carousel(images)
+        st.markdown(f"#### 🎙️ Narrated by: {narrator}")
+        st.markdown("## 🧠 Generated Story")
+        with st.container():
+            st.markdown(story, unsafe_allow_html=True)
+
+        # ✅ SIDEBAR: Wikibooks Deep Dive
+        if wikibooks:
+            with st.sidebar:
+                st.markdown("## 📚 Learn More on Wikibooks")
+                for module in wikibooks:
+                    st.markdown(f"- [{module['title']}]({module['link']})")
+
+    else:
+        st.error("Sorry, we couldn't build a story. Try another topic.")

contributing.md

@@ -0,0 +1,18 @@
+# 🤝 Contributing to WikiSage
+
+Welcome to the WikiSage project — an open knowledge app built for the WikiVerse Hackathon.  
+We’re glad you want to help make it better! 🧠
+
+Please follow these guidelines to ensure clean, stable, and collaborative development.
+
+---
+
+## 🔧 Setup Instructions
+
+To get started:
+
+1. **Clone the repository**:
+
+   ```bash
+   git clone https://gitlab.com/your-team/wiki-sage.git
+   cd wiki-sage

requirements.txt

@@ -0,0 +1,3 @@
+streamlit
+requests
+beautifulsoup4