---
title: AI NoteBook Assistant (RAG)
emoji: 🧠
colorFrom: blue
colorTo: purple
sdk: docker
app_port: 7860
---

#  AI NoteBook Assistant (RAG)  

**Chat with your notes — like having a personal tutor who’s read everything you uploaded.**  

Powered by **Retrieval-Augmented Generation (RAG)**, this app turns your static PDFs (lecture notes, textbooks, research papers) into an intelligent conversation partner.  

**Live Demo**  
**Interactive App** → [ai-notebook-rag.netlify.app](https://ai-notebook-rag.netlify.app)  
**API Docs (Swagger)** → [gvadxx-ai-notebook-assistant-rag.hf.space/docs](https://gvadxx-ai-notebook-assistant-rag.hf.space/docs)  

---

##  Why you'll love it  

- Upload a PDF **once** → ask **unlimited** questions forever  
- Answers are **100% grounded** in your notes (no hallucinations)  
- Lightning-fast responses thanks to **Groq**  
- Perfect for students, researchers, and lifelong learners  

---

##  How to use it (super simple)

### 1. Upload your notes  
```bash
curl -X POST "https://gvadxx-ai-notebook-assistant-rag.hf.space/upload_pdf/" \
  -F "file=@biology_notes.pdf"
```

### 2. Ask anything
```bash
curl -X POST "https://gvadxx-ai-notebook-assistant-rag.hf.space/ask/" \
  -d "query=Explain Griffith's experiment in simple terms"
```

**Example response**  
```json
{
  "question": "Explain Griffith's experiment in simple terms",
  "answer": "Griffith mixed heat-killed dangerous bacteria with live harmless ones. Surprisingly, the harmless bacteria turned deadly—and could pass that trait to their offspring. He had discovered the 'transforming principle'… which we now know is DNA! 🧬"
}
```

Or just open the web app and chat in your browser — no code needed!  

---

 **Tech magic behind the scenes**  

| Layer       | Technology                              | Why it rocks                          |
|-------------|-----------------------------------------|---------------------------------------|
| Frontend    | HTML • CSS • Vanilla JS                 | Loads instantly, no framework bloat   |
| Backend     | FastAPI (Python)                        | Clean, fast, auto-generated docs      |
| Embeddings  | SentenceTransformers (all-MiniLM-L6-v2) | Tiny but powerful semantic search     |
| Vector DB   | FAISS                                   | Blazing-fast similarity lookup        |
| Brain       | Groq API (gpt-oss-20b)                  | Near-instant reasoning                |
| Hosting     | Hugging Face Spaces + Netlify           | Free, scalable, zero server management|

---

 **API Endpoints**  

| Endpoint     | Method | Description                       |
|--------------|--------|-----------------------------------|
| `/upload_pdf/` | POST   | Upload & index your PDF           |
| `/ask/`        | POST   | Ask a question → get JSON answer  |
| `/`            | GET    | Redirects to the beautiful frontend |

---

💛 **Huge thanks to**  

- Groq for insane inference speed ⚡  
- Hugging Face for effortless app hosting  
- Netlify for buttery-smooth frontend deploys  
- **You** for trying it out!  

> “Notes aren’t meant to be read — they’re meant to be reasoned with.”  
> — AI NoteBook Assistant, 2025  

Made with ❤️ by **Govardhan Padmasali**  
🎓 B.Tech ECE | Embedded Systems & AI  
🔗 [LinkedIn](https://www.linkedin.com/in/govardhanpadmasali/) • [GitHub](https://github.com/PadmasaliGovardhan)