README.md

---
title: Hawkins Archive RAG (Stranger Things)
emoji: 👁
colorFrom: green
colorTo: red
sdk: docker
sdk_version: "3.10"
app_file: app.py
pinned: true
---

# 👁 Hawkins Archive RAG — Stranger Things Chatbot

A **Retrieval-Augmented Generation (RAG)** chatbot that answers questions about the **Stranger Things universe** using **semantic search + context-grounded generation**.

🔗 **Live Demo:** https://huggingface.co/spaces/siddheshrj/Stranger_things_rag

---

## 🚀 What this Space does

This chatbot:
- Takes your question (example: **"Who is Mike Wheeler?"**)  
- Retrieves the most relevant context from the Stranger Things knowledge base  
- Generates a natural response using an LLM  
- Ensures answers are structured with **relationships, role/passion, and iconic traits**

---

## ✨ Features

✅ Context-aware answers using RAG (reduces hallucination)  
✅ Stranger Things themed UI (Hawkins Lab vibe)  
✅ Fast retrieval using embeddings + similarity search  
✅ Character-focused response formatting  
✅ Hosted & deployed on Hugging Face Spaces (Docker)

---

## 🧠 How RAG Works (Simple)

RAG = **Retrieve + Generate**

1. **Retrieve:** find relevant context chunks using embeddings  
2. **Generate:** pass context + question to LLM for final answer  

This makes responses more accurate and grounded compared to plain chatbots.

---

## 🛠️ Tech Stack

- **LangChain** (RAG pipeline)
- **Embeddings**
- **Vector Database / Similarity Search**
- **LLM API**
- **Docker**
- **Hugging Face Spaces**

---

## ✅ Example Questions to Try

### Easy
- Who is Eleven?
- What is the Upside Down?
- Who are Mike’s best friends?

### Medium
- Explain Hawkins Lab in short
- How is Will connected to the Upside Down?

### Hard / Complex
- Connect Hawkins Lab, Vecna, and the Upside Down in one explanation.
- How does Mike’s leadership evolve from Season 1 to Season 4?

---

## 🔮 Future Improvements

- Add chat memory (multi-turn conversation)
- Add citations / sources in answers
- Improve retrieval accuracy (better chunking + reranking)
- Multi-agent support (MCP + tools)
- Multimodal extension (image + text)

---

## 👤 Author

**Siddhesh Jajurley**  
Hugging Face: https://huggingface.co/siddheshrj