metadata
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
API Docs (Swagger) → 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
curl -X POST "https://gvadxx-ai-notebook-assistant-rag.hf.space/upload_pdf/" \
-F "file=@biology_notes.pdf"
2. Ask anything
curl -X POST "https://gvadxx-ai-notebook-assistant-rag.hf.space/ask/" \
-d "query=Explain Griffith's experiment in simple terms"
Example response
{
"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 • GitHub