Pavaas commited on
Commit
2978189
Β·
verified Β·
1 Parent(s): 3e2ff8d

Update README.md

Browse files
Files changed (1) hide show
  1. README.md +36 -62
README.md CHANGED
@@ -6,79 +6,53 @@ colorFrom: indigo
6
  colorTo: purple
7
  sdk_version: 1.46.0
8
  ---
9
- # πŸ¦‡ BatAnki – AI Flashcard Generator
10
 
11
- BatAnki is an AI-powered flashcard generator for medical learners. Inspired by Batman, built for speed. Runs on [Hugging Face Spaces](https://huggingface.co/spaces) using `streamlit`.
12
 
13
  ---
14
 
15
- ## βœ… Features
16
-
17
- - πŸ“„ PDF β†’ Flashcards (with OCR fallback)
18
- - πŸ–ΌοΈ Image β†’ Text β†’ Flashcards (via EasyOCR)
19
- - 🎧 Audio β†’ Transcription β†’ Flashcards (via Whisper)
20
- - 🧠 AI Flashcard Generator (Q&A, Cloze, MCQ via T5)
21
- - πŸ’Ύ Export to `.apkg` (Anki deck)
22
- - πŸ¦‡ Batman/Dark theme UI
23
- - πŸ§ͺ Smart tagging and chunking
24
- - βœ… 100% free (no OpenAI API, no paid keys)
25
-
26
- ---
27
-
28
- ## πŸš€ Deployment (Hugging Face)
29
-
30
- ### Step 1: Create Space
31
-
32
- 1. Go to: [https://huggingface.co/spaces](https://huggingface.co/spaces)
33
- 2. Click **Create new Space**
34
- 3. Name it something like `batanki-app`
35
- 4. Choose **"Streamlit"**
36
- 5. Choose **"Public"** (or Private if you have Pro)
37
-
38
- ---
39
-
40
- ### Step 2: Upload Files
41
-
42
- Upload the following into your Space:
43
- - `app.py`
44
- - `config.py`
45
- - `requirements.txt`
46
- - (Optional) `README.md`
47
 
48
  ---
49
 
50
- ### Step 3: Let Hugging Face Build
51
-
52
- - It will automatically install all packages from `requirements.txt`
53
- - Wait for build to complete (~2–4 minutes)
54
- - The app will launch at `https://<your-username>.huggingface.space`
55
-
56
- ---
57
-
58
- ## 🧠 Model Details
59
-
60
- - Flashcard AI: `t5-base` (can be swapped with `BioGPT` or `medalpaca` for more clinical reasoning)
61
- - OCR: `PyMuPDF` + `pytesseract` + `easyocr`
62
- - Audio: `openai/whisper` (base model)
63
 
64
  ---
65
 
66
- ## πŸ“¦ Output
67
-
68
- - You can export your flashcards as `.apkg` (for Anki)
69
- - Flashcards support Q&A + answer-side reveal + optional cloze
70
-
71
- ---
72
-
73
- ## πŸ’‘ Notes
74
-
75
- - No external API needed
76
- - Fully runs within Hugging Face (free tier)
77
- - No login/save yet (you can add SQLite/Firestore later)
78
 
79
  ---
80
 
81
- ## ⚑ Credits
82
 
83
- - Built by Dr. Pavan Reddy (idea)
84
- - Engineered by OpenAI ChatGPT-4
 
 
 
 
 
 
 
 
 
 
 
6
  colorTo: purple
7
  sdk_version: 1.46.0
8
  ---
9
+ # πŸ¦‡ BatAnki – AI Flashcard Engine for PDF / Image / Audio / YouTube / Text
10
 
11
+ BatAnki is an offline, fully open-source, AI-powered flashcard app designed for students, medicos, and power learners. Built for Hugging Face Spaces, no API keys required.
12
 
13
  ---
14
 
15
+ ### βœ… Features (All Green Table Items Supported)
16
+ - πŸ“„ Upload & process **PDF, Image, Audio, YouTube, Text (.txt/.docx)**
17
+ - πŸ”  Extract text using **OCR**, **Whisper**, or **PyMuPDF**
18
+ - 🧠 Generate flashcards using **T5** or **BioGPT**
19
+ - πŸ’‘ Supports **Q&A, Cloze, MCQ, and Reverse cards**
20
+ - 🏷️ Tag flashcards manually
21
+ - πŸ’Ύ Export to **Anki (.apkg)** and **CSV**
22
+ - 🧾 Inline preview & edit of each card
23
+ - 🎨 Light/Dark themes with Batman-style layout
24
+ - βš™οΈ 100% deployable without any paid APIs
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
25
 
26
  ---
27
 
28
+ ### 🧠 Models Used
29
+ - `t5-base` (general QA generation)
30
+ - `microsoft/BioGPT` (medical/scientific Q&A)
31
+ - `openai/whisper` (audio transcription)
32
+ - `easyocr` + `pytesseract` (OCR engine)
 
 
 
 
 
 
 
 
33
 
34
  ---
35
 
36
+ ### πŸ’» Usage Instructions
37
+ 1. πŸ“ Upload a file (PDF, Image, Audio, Text) or paste a YouTube link
38
+ 2. 🎯 Choose the card types you want (Q&A, Cloze, MCQ, Reverse)
39
+ 3. πŸš€ Click **Extract Text**, then **Generate Flashcards**
40
+ 4. ✍️ Edit, tag, and preview each card
41
+ 5. ⬇️ Export as `.apkg` or `.csv`
 
 
 
 
 
 
42
 
43
  ---
44
 
45
+ ### πŸ›  Requirements
46
 
47
+ ```bash
48
+ streamlit
49
+ transformers
50
+ torch
51
+ genanki
52
+ easyocr
53
+ PyMuPDF
54
+ pytesseract
55
+ whisper
56
+ yt-dlp
57
+ python-docx
58
+ Pillow