---
title: RAGBot
emoji: 🤖
colorFrom: blue
colorTo: indigo
sdk: docker
pinned: false
license: mit
---

# 🤖 RAGBOT

A cloud-native, multi-tenant AI chatbot that instantly learns the content of
any website and answers questions in real-time.
Built for the Cloud Computing final project.

## 🚀 Key Features

- **Universal Ingestion:** Crawls and indexes any provided URL
  (e.g., University sites, NGOs, Government portals) on-demand.

- **SaaS Architecture:** Uses **Multi-Tenancy** via Vector Database
  Namespacing to isolate customer data within a single index.

- **RAG Pipeline:** Combines **Semantic Search** (Pinecone)
  with **LLM Generation** (Gemini 2.0 Flash) for hallucination-free answers.

- **Client-Server Model:** Decoupled FastAPI Backend and Chrome Extension Frontend.

- **Asynchronous Processing:** Background workers handle
  heavy scraping tasks without blocking the UI.

## 🛠️ Tech Stack

### **Backend (Cloud Engine)**

- **Framework:** FastAPI (Python)
- **Vector Database:** Pinecone (Serverless AWS)
- **LLM:** Google Gemini 2.0 Flash
- **Crawler:** Trafilatura (Sitemap & Content Discovery)
- **Embeddings:** Sentence-Transformers (`all-MiniLM-L6-v2`)

### **Frontend (Client)**

- **Interface:** Google Chrome Extension (Manifest V3)
- **Interaction:** Real-time Polling & Dynamic UI

## 📂 Project Structure

```bash
ragbot/
├── README.md           # Documentation
├── api/                # 🐍 Backend Logic
│   ├── config.py       # Environment & Logging setup
│   ├── crawler.py      # Logic for sitemap parsing & scraping
│   ├── schemas.py      # Pydantic data models
│   ├── server.py       # Main FastAPI entry point
│   ├── utils.py        # Security & URL validation
│   └── vectorstore.py  # Pinecone batching & management
├── chrome-extension/   # 🧩 Frontend Client
│   ├── background.js   # On-click sidepanel logic
│   ├── icons/          # Chrome Extension icons
│   │   ├── icon128.png
│   │   ├── icon16.png
│   │   ├── icon32.png
│   │   └── icon48.png
│   ├── manifest.json   # Setup for Chrome Extension
│   ├── sidepanel.css   # UI
│   ├── sidepanel.html  # HTML Contents
│   └── sidepanel.js    # Main UI logic
└── requirements.txt    # Python dependencies
```