An AI-powered Intelligent Learning & IQ Assessment System
Built with ❤️ using FastAPI & React.js
MindVault is an AI-driven education platform designed to test and enhance human memorization and intelligence through Generative AI.
Users can upload PDFs or images, and the system will:
- Extract text via OCR (Tesseract)
- Generate smart, contextual questions using Transformer models (T5, Sentence-BERT)
- Evaluate answers to estimate IQ level and memory retention power
🧩 In short — MindVault helps you read, recall, and reason — like training your mind with AI.
| 🧠 Feature | 💡 Description |
|---|---|
| 📄 Smart File Uploads | Upload PDFs or images — MindVault automatically extracts text content. |
| 🧩 AI Question Generation | Uses transformer models to generate meaningful questions from content. |
| ⚙️ FastAPI Backend | Handles OCR, AI inference, and scoring logic securely and efficiently. |
| 💻 React Frontend | Clean, responsive dashboard for uploads, answers, and analytics. |
| 🔍 IQ & Memory Analysis | Predicts your intelligence and recall performance dynamically. |
| 🔄 Adaptive Learning | Adjusts question difficulty based on user performance. |
| ☁️ Cloud Ready | Scalable deployment on AWS / GCP / Azure with GPU acceleration. |
| Layer | Technology |
|---|---|
| Frontend | React.js, Tailwind CSS |
| Backend | FastAPI, PyTorch, Transformers, PyMuPDF (fitz), pytesseract |
| AI Models | T5-base, Sentence-BERT |
| Database | PostgreSQL / Firebase |
| Cloud & Tools | AWS S3, Docker, Git, VS Code |
Follow these simple steps to run MindVault locally 👇
git clone https://github.com/<your-username>/MindVault.git
cd "MindVault Project App"cd backend
python -m venv venv
venv\Scripts\activate # On Windows
pip install -r requirements.txt
python main.py👉 Access API Docs: http://127.0.0.1:8000/docs
cd frontend
npm install
npm start👉 Frontend runs at: http://localhost:3000
- 📤 Upload a PDF/Image
- 🔍 OCR Engine extracts text
- 🤖 Transformer model (T5) generates smart questions
- 🧮 User answers → AI predicts IQ & memory score
- 📊 Results displayed on dashboard with improvement insights
| Method | Endpoint | Description |
|---|---|---|
POST |
/upload/ |
Upload a PDF or image and generate questions. |
GET |
/health |
Check server health status. |
📘 Swagger Docs: http://127.0.0.1:8000/docs
MindVault Project App/
│
├── backend/
│ ├── main.py
│ ├── model/
│ │ ├── config.json
│ │ ├── tokenizer_config.json
│ │ ├── model.safetensors
│ └── ...
│
├── frontend/
│ ├── src/
│ ├── package.json
│ └── ...
│
├── .gitignore
├── README.md
└── requirements.txt
[User Uploads File] → [FastAPI Backend]
↓
OCR (Tesseract)
↓
Transformer Model (T5)
↓
Generate Questions + Evaluate Answers
↓
Return IQ & Memory Score
↓
[React Frontend Dashboard]
| Phase | Goal | Status |
|---|---|---|
| Phase 1 | Research & Planning | ✅ Completed |
| Phase 2 | Model Integration | ✅ Done |
| Phase 3 | Prototype Build | ✅ Tested |
| Phase 4 | Optimization & Testing | ⚙️ In progress |
| Phase 5 | Deployment | 🚀 Coming Soon |
| Phase 6 | Scaling & Gamification | 🔜 Planned |
This project is licensed under the MIT License.
Supriya Mishra 💼 AI Engineer 📧 Email 🌐 GitHub | LinkedIn
“Read • Think • Answer • Evolve – MindVault helps you unlock the power of your mind.”
⭐ Don’t forget to star the repo if you found it useful!
- Center-aligned header & badges
- Emoji-based sections
- Markdown tables for clarity
- Syntax-highlighted commands
- Screenshot placeholders
- Collapsible feel with clean visual hierarchy
- Perfect for GitHub dark mode