README.md

metadata

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