Spaces:
Sleeping
Sleeping
| description = """ | |
| ## 🕉️ **Project Title: Epic-Minds 🏹🛞** | |
| --- | |
| ### 🔍 **Project Overview** | |
| **RamayanaGPT** and **GitaGPT** are intelligent chatbots designed to answer spiritual and literary questions from the *Valmiki Ramayana* and the *Bhagavad Gita* respectively. They follow a **Retrieval-Augmented Generation (RAG)** pipeline to ensure that the responses are contextually grounded in the scriptures. | |
| These tools integrate: | |
| - **MongoDB Atlas Vector Search** for semantic document retrieval | |
| - **Hugging Face embeddings** (`intfloat/multilingual-e5-base`) | |
| - **Gemini Flash 1.5 API** as the large language model | |
| - **LlamaIndex** for orchestration and query handling | |
| - **Gradio** for a clean and simple user interface | |
| --- | |
| ### 🏗️ **Key Components** | |
| #### 1. **Vector Store: MongoDB Atlas** | |
| - Two collections are created in the `RAG` database: | |
| - `ramayana` for **Valmiki Ramayana** | |
| - `bhagavad_gita` for **Bhagavad Gita** | |
| - Each collection has an associated vector index: | |
| - `ramayana_vector_index` | |
| - `gita_vector_index` | |
| Each document includes: | |
| - **Ramayana**: `kanda`, `sarga`, `shloka`, `shloka_text`, `explanation` | |
| - **Gita**: `Title`, `Chapter`, `Verse`, `explanation` | |
| #### 2. **Vector Embedding: Hugging Face** | |
| - Model used: `intfloat/multilingual-e5-base` | |
| - Text format for embedding: `shloka_text + explanation` or `verse + explanation` | |
| - Indexed into MongoDB for fast semantic retrieval | |
| #### 3. **Language Model: Gemini Flash** | |
| - Model: `gemini-1.5-flash` | |
| - Integrated via `llama_index.llms.gemini.Gemini` | |
| - API key loaded from environment variables | |
| - No user input required for keys—simplifies interface and experience | |
| #### 4. **Prompt Engineering** | |
| Custom **PromptTemplates** for each chatbot to guide structured, scripture-faithful responses. | |
| - **RamayanaGPT Prompt**: | |
| - Intro or overview of the query | |
| - Related Sanskrit shloka(s) with explanation | |
| - Summary of the topic | |
| - **GitaGPT Prompt**: | |
| - Spiritual or contextual introduction | |
| - Relevant verse(s) and meaning | |
| - Reflective conclusion | |
| #### 5. **Index Initialization** | |
| - Vector indices are initialized **once** at app startup: | |
| ```python | |
| ramayana_index = get_vector_index("RAG", "ramayana", "ramayana_vector_index") | |
| gita_index = get_vector_index("RAG", "bhagavad_gita", "gita_vector_index") | |
| ```` | |
| * Shared across sessions for efficiency | |
| #### 6. **User Interface: Gradio** | |
| * Built using `gr.Blocks` with the `Soft` theme and `Roboto Mono` font | |
| * Clean tabbed interface: | |
| * 🕉️ **RamayanaGPT** | |
| * 🕉️ **GitaGPT** | |
| * Each tab features: | |
| * Overview accordion | |
| * Chat window powered by `gr.ChatInterface` | |
| --- | |
| ### ⚙️ **Technical Stack** | |
| | Component | Technology | | |
| | --------------- | ------------------------------------- | | |
| | Backend LLM | Gemini Flash 1.5 (via API) | | |
| | Embedding Model | Hugging Face (`multilingual-e5-base`) | | |
| | Vector Store | MongoDB Atlas Vector Search | | |
| | Vector Engine | LlamaIndex VectorStoreIndex | | |
| | Prompt Engine | LlamaIndex PromptTemplate | | |
| | Query Engine | LlamaIndex Query Engine | | |
| | UI Framework | Gradio (Blocks + ChatInterface) | | |
| | Deployment | Python app using `app.py` | | |
| --- | |
| ### ✅ **Features Implemented** | |
| * [x] Vector search using MongoDB Atlas | |
| * [x] Hugging Face embedding integration | |
| * [x] Gemini Flash 1.5 LLM integration | |
| * [x] Structured prompts per scripture | |
| * [x] Tabbed Gradio UI for easy switching | |
| * [x] Collapsible summaries for each section | |
| * [x] Query logging with timestamp | |
| --- | |
| """ | |
| groq_api_key = """ | |
| ### 🔑 How to Get a Groq API Key | |
| 1. **Go to** [https://console.groq.com/keys](https://console.groq.com/keys) | |
| 2. **Log in or Sign Up** for a Groq account. | |
| 3. Click **"API Keys"** from the dashboard. | |
| 4. Click **"Create Key"**, name it, and generate. | |
| 5. **Copy the API key** and store it securely. | |
| 6. **Paste** the key into the RamayanaGPT app to start chatting. | |
| --- | |
| ⚠️ **Don't share** your API key. Revoke and regenerate if needed. | |
| """ | |
| RamayanaGPT=''' | |
| ## 🕉️ **RamayanaGPT – Overview and Dataset Summary** | |
| ### 📖 **Introduction** | |
| **RamayanaGPT** is a RAG-based chatbot that draws upon the **Valmiki Ramayana**, the original Sanskrit epic, to answer user queries with reference to shlokas and their commentaries. It aims to offer precise, contextual, and respectful responses using advanced retrieval and generation technologies. | |
| ### 🗂️ **Dataset Structure** | |
| The uploaded Ramayana dataset includes the following columns: | |
| | Column | Description | | |
| | ------------- | ------------------------------------------------------------------------------ | | |
| | `kanda` | One of the 7 books (kandas) of the Ramayana (e.g., Bala Kanda, Ayodhya Kanda). | | |
| | `sarga` | The chapter number within each kanda. | | |
| | `shloka` | The shloka (verse) number within the sarga. | | |
| | `shloka_text` | Original Sanskrit verse. | | |
| | `explanation` | English explanation or interpretation of the shloka. | | |
| ### 🔍 **Example** | |
| ```text | |
| kanda: Bala Kanda | |
| sarga: 1 | |
| shloka: 1 | |
| shloka_text: तपस्स्वाध्यायनिरतं तपस्वी वाग्विदां वरम् । | |
| explanation: Ascetic Valmiki enquired of Narada, preeminent among sages, who was engaged in penance and study of the Vedas. | |
| ``` | |
| ### 💡 **Insights** | |
| * The data is well-structured with nearly **1,400+** records. | |
| * Each record reflects a deep philosophical or narrative moment from the epic. | |
| * Metadata (`kanda`, `sarga`, `shloka`) allows precise retrieval and organization. | |
| * Used for vector indexing and semantic retrieval. | |
| ''' | |
| GitaGPT=''' | |
| ## 🕉️ **GitaGPT – Overview and Dataset Summary** | |
| ### 📖 **Introduction** | |
| **GitaGPT** is a chatbot built to answer spiritual and philosophical questions using the **Bhagavad Gita** as its primary source. It references verses (slokas) directly from the Gita, delivering insights supported by both Sanskrit, Hindi, and English explanations. | |
| ### 🗂️ **Dataset Structure** | |
| The uploaded Gita dataset contains the following fields: | |
| | Column | Description | | |
| | --------------------- | --------------------------------------------------- | | |
| | `S.No.` | Serial number of the verse. | | |
| | `Title` | Title of the chapter (e.g., Arjuna's Vishada Yoga). | | |
| | `Chapter` | Gita chapter number (e.g., Chapter 1). | | |
| | `Verse` | Verse ID (e.g., Verse 1.1). | | |
| | `Sanskrit Anuvad` | Original verse in Devanagari Sanskrit. | | |
| | `Hindi Anuvad` | Hindi translation/interpretation. | | |
| | `Enlgish Translation` | English translation/interpretation. | | |
| ### 🔍 **Example** | |
| ```text | |
| Chapter: Chapter 1 | |
| Verse: Verse 1.1 | |
| Sanskrit: धृतराष्ट्र उवाच । धर्मक्षेत्रे कुरुक्षेत्रे समवेता युयुत्सवः... | |
| Hindi: धृतराष्ट्र बोले- हे संजय! धर्मभूमि कुरुक्षेत्र में एकत्र हुए युद्ध की इच्छा रखने वाले... | |
| English: Dhrtarashtra asked of Sanjaya: O SANJAYA, what did my sons and the sons of Pandu do? | |
| ``` | |
| ### 💡 **Insights** | |
| * The dataset contains **700+ verses** from all 18 chapters. | |
| * Multilingual representation (Sanskrit, Hindi, English) enhances usability for diverse users. | |
| * The verse structure (`Chapter`, `Verse`) aids in precise referencing and response generation. | |
| * Perfectly suited for semantic search via vector embeddings. | |
| ''' | |
| footer = """ | |
| <div style="background-color: #1d2938; color: white; padding: 10px; width: 100%; bottom: 0; left: 0; display: flex; justify-content: space-between; align-items: center; padding: .2rem 35px; box-sizing: border-box; font-size: 16px;"> | |
| <div style="text-align: left;"> | |
| <p style="margin: 0;">© 2025 </p> | |
| </div> | |
| <div style="text-align: center; flex-grow: 1;"> | |
| <p style="margin: 0;"> This website is made with ❤ by SARATH CHANDRA</p> | |
| </div> | |
| <div class="social-links" style="display: flex; gap: 20px; justify-content: flex-end; align-items: center;"> | |
| <a href="https://github.com/21bq1a4210" target="_blank" style="text-align: center;"> | |
| <img src="data:image/png;base64,{}" alt="GitHub" width="40" height="40" style="display: block; margin: 0 auto;"> | |
| <span style="font-size: 14px;">GitHub</span> | |
| </a> | |
| <a href="https://www.linkedin.com/in/sarath-chandra-bandreddi-07393b1aa/" target="_blank" style="text-align: center;"> | |
| <img src="data:image/png;base64,{}" alt="LinkedIn" width="40" height="40" style="display: block; margin: 0 auto;"> | |
| <span style="font-size: 14px;">LinkedIn</span> | |
| </a> | |
| <a href="https://21bq1a4210.github.io/MyPortfolio-/" target="_blank" style="text-align: center;"> | |
| <img src="data:image/png;base64,{}" alt="Portfolio" width="40" height="40" style="display: block; margin-right: 40px;"> | |
| <span style="font-size: 14px;">Portfolio</span> | |
| </a> | |
| </div> | |
| </div> | |
| """ |