Asalun commited on
Commit
3c8f545
Β·
verified Β·
1 Parent(s): 7fae88d

Update README.md

Browse files
Files changed (1) hide show
  1. README.md +29 -23
README.md CHANGED
@@ -1,44 +1,50 @@
1
  ---
2
- title: Study RAG Assistant UI Mock
3
  emoji: πŸ“š
4
  colorFrom: blue
5
  colorTo: indigo
6
  sdk: gradio
 
7
  pinned: false
8
  ---
9
 
10
- # Study RAG Assistant (UI Mock)
11
 
12
- This Space hosts a **frontend UI mock** for a "Study RAG Assistant" that supports:
13
- - Uploading up to **10 Jupyter notebooks (.ipynb)** and **5 PDFs**
14
- - Browsing sources
15
- - Chat / Notes / Quiz tabs
16
- - Citation-style UI components
17
- - Preview modal (mock)
18
 
19
- βœ… **Note:** This Space is a **static UI only** (no backend connected yet).
20
- It is meant to help decide the interface before wiring the real RAG pipeline.
 
 
 
21
 
22
  ---
23
 
24
- ## βœ… How to Deploy (Hugging Face Spaces)
25
 
26
- ### 1) Create a new Space
27
- - Go to **Hugging Face β†’ Spaces β†’ Create new Space**
28
- - Choose **SDK: Static**
29
- - Name it anything (e.g., `study-rag-ui`)
30
 
31
- ### 2) Upload these files into the Space repo
32
- Required:
33
- - `index.html` ← (your UI HTML file)
 
 
 
 
34
 
35
- Optional:
36
- - `README.md` (this file)
 
37
 
38
- ### 3) Done
39
- Hugging Face will automatically serve `index.html`.
 
 
 
40
 
41
  ---
42
 
43
- ## πŸ“ Expected Repo Structure
 
 
44
 
 
1
  ---
2
+ title: Study RAG Assistant
3
  emoji: πŸ“š
4
  colorFrom: blue
5
  colorTo: indigo
6
  sdk: gradio
7
+ app_file: app.py
8
  pinned: false
9
  ---
10
 
11
+ # πŸ“š Study RAG Assistant (Functional RAG)
12
 
13
+ This Hugging Face Space runs a **fully functional Retrieval-Augmented Generation (RAG)** system built with:
 
 
 
 
 
14
 
15
+ - Gradio (UI)
16
+ - FAISS (vector search)
17
+ - Sentence Transformers (embeddings)
18
+ - Transformers (LLM generation)
19
+ - PDF + Jupyter Notebook parsing
20
 
21
  ---
22
 
23
+ ## πŸš€ What It Does
24
 
25
+ You can:
 
 
 
26
 
27
+ - Upload up to 10 `.ipynb` notebooks
28
+ - Upload up to 5 `.pdf` files
29
+ - Index them into vector embeddings
30
+ - Chat grounded strictly in your documents
31
+ - Generate structured Notes
32
+ - Generate tricky Quiz questions (10–50)
33
+ - See citations from retrieved chunks
34
 
35
+ ---
36
+
37
+ ## βš™οΈ How It Works
38
 
39
+ 1. Files are parsed and chunked
40
+ 2. Chunks are embedded using `all-MiniLM-L6-v2`
41
+ 3. FAISS stores embeddings for fast retrieval
42
+ 4. Top-k chunks are retrieved per query
43
+ 5. The LLM generates grounded responses
44
 
45
  ---
46
 
47
+ ## πŸ“ Required Files
48
+
49
+ This Space must contain:
50