🎯 Vision

Virtual Intelligence and Strategic Infrastructure for Outstanding NEET-JEE

📋 Table of Contents

🎯 Vision
✨ Key Features
🏗️ Architecture
📁 Project Structure
⚙️ Tech Stack
🔐 Authentication & Security
🤖 AI Integration
📱 Frontend Pages
🌐 Backend API
🎨 Design System
🚀 Getting Started
📊 Feature Status
👥 Contributors
🤝 Contributing
📄 License

Vision is a next-generation AI-powered tutoring platform designed to revolutionize exam preparation for India's most demanding entrance exams: JEE (engineering) and NEET (medical).

By combining:

🧠 Intelligent AI Tutoring — Real-time, personalized explanations
🧪 Adaptive Test Generation — NTA-style mock exams tailored to your weaknesses
📊 Advanced Analytics — Data-driven insights into your learning journey
🎓 Teacher Tools — Comprehensive student monitoring and AI-powered interventions
🎮 Gamification — Badges, streaks, and leaderboards to keep you motivated

✨ Key Features

🎓 For Students

Feature	Description
🤖 AI Tutor	Real-time streaming chat with LaTeX math support, voice input, and concept mapping
📝 Mock Tests	AI-generated NTA-style exams with live scoring, question palette, and timer
📚 Study Path	Interactive SVG-based roadmap with parallel learning tracks and progress nodes
📊 Analytics	Score trends, subject mastery breakdown, and personalized insights
🏆 Achievements	Gamified badges, XP system, and global leaderboard
🎤 Voice I/O	Speech-to-text tutoring and real-time responses

👨‍🏫 For Teachers

Feature	Description
👥 Student Monitoring	Real-time dashboard with mastery tracking and performance trends
🚨 AI Alerts	Automatic detection of struggling students with intervention recommendations
📊 Cohort Analytics	Class-level performance insights and student status overview

🏗️ Architecture

System Overview

graph TB
    subgraph Client["🖥️ Frontend Layer"]
        React["React 18 + Vite"]
        UI["Components<br/>Pages<br/>Contexts"]
    end

    subgraph API["⚙️ Backend Layer"]
        FastAPI["FastAPI Server"]
        Auth["Auth Module<br/>JWT + bcrypt"]
        Routes["Route Handlers<br/>Chat • Tests • Results"]
        DB["Database Layer<br/>SQLAlchemy ORM"]
    end

    subgraph AI["🤖 AI Engine"]
        Ollama["Ollama Server<br/>localhost:11434"]
        Gemma["Gemma 3 4B<br/>Local LLM"]
    end

    subgraph Storage["💾 Storage"]
        SQLite["SQLite<br/>Development"]
        PostgreSQL["PostgreSQL<br/>Production"]
    end

    Client -->|HTTP/SSE| API
    API -->|Query/Store| DB
    DB -->|SQLite| Storage
    DB -->|PostgreSQL| Storage
    API -->|LLM Prompts| Ollama
    Ollama -->|Model Inference| Gemma

    style Client fill:#e3f2fd
    style API fill:#fff3e0
    style AI fill:#f3e5f5
    style Storage fill:#e8f5e9

Data Flow

sequenceDiagram
    participant User as 👤 User
    participant Frontend as ⚛️ Frontend
    participant Backend as ⚙️ Backend
    participant Ollama as 🤖 Ollama
    participant DB as 💾 Database

    User->>Frontend: Ask question
    Frontend->>Backend: POST /api/chat/stream
    Backend->>Ollama: Send prompt + context
    Ollama->>Backend: Stream LLM response
    Backend->>Frontend: SSE stream
    Frontend->>User: Display response

    User->>Frontend: Start mock test
    Frontend->>Backend: POST /api/generate-test
    Backend->>Ollama: Generate questions (JSON)
    Ollama->>Backend: Questions array
    Backend->>Frontend: Test metadata
    Frontend->>User: Render NTA interface

    User->>Frontend: Submit test
    Frontend->>Backend: POST /api/tests/submit
    Backend->>DB: Save attempt + responses
    Backend->>Ollama: Analyze performance
    Backend->>Frontend: Feedback + AI insights
    Frontend->>User: Performance report

📁 Project Structure

vision/
│
├── 📄 README.md                          # Project documentation
├── 📄 LICENSE                            # MIT License
├── 📄 .gitignore                         # Git ignore rules
│
├── 🔙 backend/                           # FastAPI Backend
│   ├── 📄 main.py                        # Application entry point
│   ├── 📄 database.py                    # SQLAlchemy configuration
│   ├── 📄 models.py                      # Pydantic schemas
│   ├── 📄 ollama_service.py              # AI/LLM integration
│   ├── 📄 requirements.txt               # Python dependencies
│   ├── 📄 .env.example                   # Environment template
│   ├── 📄 vision.db                      # SQLite database (gitignored)
│   │
│   ├── 🔐 auth/                          # Authentication module
│   │   ├── 📄 models.py                  # SQLAlchemy ORM (User, Session, etc.)
│   │   ├── 📄 router.py                  # Auth endpoints (/register, /login, /me)
│   │   ├── 📄 schemas.py                 # Pydantic request/response schemas
│   │   └── 📄 utils.py                   # Password hashing & JWT utils
│   │
│   └── 🛣️ routes/                        # API route handlers
│       ├── 📄 __init__.py
│       ├── 📄 chat.py                    # Chat & streaming endpoints
│       ├── 📄 test_generator.py          # Test generation endpoint
│       └── 📄 results.py                 # Results & analysis endpoints
│
└── 🎨 frontend/                          # React Frontend (Vite)
    ├── 📄 index.html                     # HTML entry point
    ├── 📄 package.json                   # NPM dependencies
    ├── 📄 vite.config.js                 # Vite configuration
    ├── 📄 tailwind.config.js             # TailwindCSS config
    ├── 📄 postcss.config.js              # PostCSS config
    │
    └── 📂 src/                           # Source code
        ├── 📄 main.jsx                   # React DOM render
        ├── 📄 App.jsx                    # Router & providers
        ├── 📄 index.css                  # Global styles
        │
        ├── 📂 context/                   # State management
        │   ├── 📄 AuthContext.jsx        # Authentication state
        │   └── 📄 ThemeContext.jsx       # Theme (dark/light)
        │
        ├── 📂 components/                # Reusable components
        │   └── 📄 Sidebar.jsx            # Navigation sidebar
        │
        └── 📂 pages/                     # Page components
            ├── 📄 LoginPage.jsx          # Dual-portal login
            ├── 📄 RegisterPage.jsx       # Multi-step registration
            ├── 📄 OnboardingPage.jsx     # Profile setup
            ├── 📄 DashboardPage.jsx      # Student dashboard
            ├── 📄 AiTutorPage.jsx        # AI chat interface
            ├── 📄 MockTestPage.jsx       # NTA exam interface
            ├── 📄 StudyPathPage.jsx      # SVG study roadmap
            ├── 📄 ProgressPage.jsx       # Analytics dashboard
            ├── 📄 AchievementsPage.jsx   # Gamification hub
            ├── 📄 TeacherPanelPage.jsx   # Teacher dashboard
            └── 📄 SettingsProfilePage.jsx # User settings

⚙️ Tech Stack

🎨 Frontend

Technology	Purpose
React 18	Component-based UI framework
Vite 5	Lightning-fast bundler & dev server
React Router 6	Client-side navigation & routing
TailwindCSS 3.4	Utility-first CSS framework
react-markdown	Render AI responses with Markdown
remark-math + rehype-katex	LaTeX equation rendering in chat
Google Fonts	Space Grotesk (headings), Inter (body)

⚙️ Backend

Technology	Purpose
FastAPI	Async Python web framework
Uvicorn	ASGI application server
SQLAlchemy	Database ORM & abstraction layer
python-jose + bcrypt	JWT tokens & password hashing
httpx	Async HTTP client for Ollama API
python-dotenv	Environment variable configuration

🤖 AI Engine

Component	Details
Ollama	Local LLM server (privacy-first, no cloud calls)
Gemma 3 4B	Efficient 4B parameter language model

💾 Database

Environment	Database
Development	SQLite (file-based)
Production	PostgreSQL (scalable)

🔐 Authentication & Security

Authentication Flow

stateDiagram-v2
    [*] --> Registration
    Registration --> Dashboard: Success
    
    [*] --> Login
    Login --> PasswordCheck: Email exists
    PasswordCheck --> SessionCreate: Password matches
    SessionCreate --> JWTGeneration: Session saved
    JWTGeneration --> Dashboard: Token issued
    
    Dashboard --> Authenticated: Bearer token in headers
    Authenticated --> ProtectedRoutes: Token valid
    ProtectedRoutes --> Dashboard: Continue
    
    Dashboard --> Logout: User initiated
    Logout --> [*]

Security Features

Feature	Implementation
Password Security	bcrypt hashing (10 rounds)
Token Auth	JWT with 7-day expiry
CORS	Configurable allowed origins
Authorization	Role-based access control (RBAC)
Session Tracking	Database-backed session records
Secret Management	.env file for sensitive configs

User Roles & Permissions

👤 STUDENT

Access all student pages (Dashboard, AI Tutor, Mock Tests, Study Path, Progress, Achievements, Settings)
Personalized AI tutoring based on weak topics
AI-generated mock tests
Performance tracking and analytics

👨‍🏫 TEACHER

Teacher Panel (student monitoring dashboard)
Real-time student performance tracking
AI-powered alerts for struggling students
Cohort analytics and insights

🤖 AI Integration

Ollama Architecture

The platform uses Ollama with Gemma 3 4B for local, privacy-first AI inference:

┌─────────────────────────────────────┐
│    FastAPI Backend                  │
│  ┌─────────────────────────────┐   │
│  │  ollama_service.py          │   │
│  │  ├─ Prompt engineering      │   │
│  │  ├─ Response streaming      │   │
│  │  └─ Health monitoring       │   │
│  └─────────────────────────────┘   │
└────────────┬────────────────────────┘
             │ HTTP
             ▼
┌─────────────────────────────────────┐
│   Ollama Server (localhost:11434)   │
│   └─ Gemma 3 4B Model             │
│      ├─ Text Generation            │
│      ├─ Streaming Responses        │
│      └─ JSON Output Generation     │
└─────────────────────────────────────┘

AI Modes

Each AI interaction operates in a specialized mode with custom system prompts:

Mode	Purpose	Use Case	Output
tutor	Conversational tutoring	"Explain quantum mechanics"	Markdown + LaTeX
test	MCQ generation	Generate 5 physics questions	Strict JSON
feedback	Performance analysis	Post-test insights	Structured JSON
diagnostic	Baseline assessment	10-question initial test	JSON array

Context-Aware Personalization

Every AI call includes student profile data:

📝 Name, class level, target exam
📚 Weak topics and strong topics list
📊 Last test score and trends
⏱️ Time spent on previous topics

📱 Frontend Pages

1️⃣ Login Page (`/login`)

Dual-portal authentication with role selection:

┌─────────────────────────────────────────────┐
│  Vision Login                               │
├─────────────────────────────────────────────┤
│                                             │
│  [Student 🎓] [Teacher 👨‍🏫]          │
│                                             │
│  Email: [ _________________ ]              │
│  Password: [ _____________ ] [👁️]        │
│  [ Remember me ]                           │
│                                             │
│  [ Login ] [ Register ]                    │
│                                             │
└─────────────────────────────────────────────┘

Features:

✅ Split-screen layout with feature highlights
✅ Show/hide password toggle
✅ Role-specific color theming (Sky blue for students, Purple for teachers)
✅ Auto-redirect to appropriate dashboard

2��⃣ Registration Page (`/register`)

Multi-step wizard with smooth animations:

Student Flow (3 steps):

Account creation with email validation
Class level (11th/12th/Dropper), exam type (JEE/NEET/Both), exam date
Weak subject selection for personalization

Teacher Flow (2 steps):

Account details
Subject expertise and credentials

3️⃣ Dashboard (`/dashboard`)

Main hub for student engagement:

┌────────────────────────────────────────────────────┐
│ Hey Anuj! 🎯 | Streak: 15 days 🔥 | Rank: #42    │
├────────────────────────────────────────────────────┤
│                                                    │
│ 🧠 Neural Sync Mission                            │
│ ├─ Suggested: Quantum Mechanics (90 XP reward)   │
│ └─ [Radar Chart visualization]                   │
│                                                    │
│ 📊 ACTIVITY STREAM                               │
│ ├─ 2h Focus Session                              │
│ ├─ Mock: Physics (Score 85%)                    │
│ ├─ 7 Day Streak Reached!                        │
│ └─ Weak Spot Patch: Thermodynamics              │
│                                                    │
│ 🏆 POWER RANKING (Leaderboard)                   │
│ 1. Ravi Kumar     2450 XP                        │
│ 2. Priya Singh    2210 XP                        │
│ 3. Arjun Patel    1980 XP                        │
│ 🔷 You (7th)      1650 XP                        │
│                                                    │
│ 💡 Daily Brain Fuel: "Success is..."             │
│ 🎮 Next Unlock: 86% → Unlock Advanced Mode       │
│                                                    │
└────────────────────────────────────────────────────┘

4️⃣ AI Tutor (`/chat`)

Real-time streaming chat with advanced features:

┌──────────────────────────────────────────────────────┐
│ Vision AI Tutor                                      │
├──────────────────────────────────────────────────────┤
│                                                      │
│ LEFT PANEL             │  CHAT AREA                 │
│ ─────────────────────  │  ─────────────────────    │
│ 🧠 Concept Map         │  AI: Let me explain...   │
│ • Vectors              │  [LaTeX rendering]       │
│ • Calculus             │  [Markdown formatting]   │
│ • Integration          │                          │
│                        │  You: Ask follow-up?    │
│ Frequent Gaps          │  [Voice input: 🎤]      │
│ • Projectile Motion    │                          │
│ • Integration by Parts │  💡 Suggestions:       │
│                        │  ["Explain", "Problem", │
│ [🔄 Reset Chat]        │   "Example"]            │
│                        │                          │
│                        │ [Typing ⚪⚪⚪]        │
│                        │                          │
│ [📝 Input...] [🎤]    │                          │
│ [Send]                 │                          │
│                                                      │
└──────────────────────────────────────────────────────┘

Features:

🔴 Live streaming via Server-Sent Events (SSE)
📐 Math rendering with LaTeX/KaTeX
🎤 Voice input via Web Speech API
📚 Concept mapping with linked topics
💬 Quick suggestions for common queries
✨ Markdown formatting for rich text

5️⃣ Mock Test (`/test`)

NTA-style exam interface with professional features:

SETUP SCREEN              ACTIVE EXAM                  RESULTS
Subject ▼               ┌─ Q1 □ Q2 ✓ Q3 ⓜ Q4 -┐   Score: 85/100
Chapter ▼               │                      │   Accuracy: 85%
Difficulty ▼            │ Q1. A + B = ?        │   Rank Est: #234
Questions: 5 10 ⓞ      │ (a) 10  (b) 20      │
                        │ (c) 30  (d) 40      │   ⏱️ Time: 45min
[Generate Test]         │                      │
                        │ [◀ Previous] [Next ▶]  📊 ANALYSIS
                        │ [Mark for Review]    │   • Conceptual gaps
                        │ [Clear Response]     │   • 3-day revision
                        │                      │   • Topic breakdown
                        │ Time: 00:45:30       │
                        │ Score: +4 -1 = 85%  │
                        │                      │
                        └──────────────────────┘

Features:

⏱️ Live countdown timer (HH:MM:SS)
🎯 Color-coded palette (Answered/Not answered/Marked/Not visited)
📝 NTA marking scheme (+4 for correct, -1 for wrong)
🔢 Question palette sidebar for navigation
📐 LaTeX rendering in questions and options
📊 AI analysis with conceptual feedback

6️⃣ Study Path (`/study-path`)

Interactive SVG roadmap with parallel tracks:

        LEFT TRACK              CENTER TRACK            RIGHT TRACK
        ──────────             ──────────              ──────────
        Math                   Physics                 Experimental
        │                      │                       │
        ├─ Vectors ────┐       ├─ Kinematics ✓        ├─ Vernier ✓
        │              │       │  [Active ▶]          │
        ├─ Calculus    └──────→├─ Projectile          ├─ Screw Gauge
        │ [Locked 🔒]          │                      │ [Locked 🔒]
        │                      ├─ Newton's Laws       │
        └─ ★ Reward           ├─ Work & Energy ⓜ     └─ ★ Lab Expert
                               │ [Marked]
                               └─ ★ Physics Master

Features:

🎨 Bezier curve edges with glowing effects
🌟 Node types: Done (✓), Active (▶), Locked (🔒), Reward (★)
📊 Grid background for sci-fi aesthetic
👆 Clickable nodes with side panel details
🎯 Action buttons: Resume, Start, Practice Test

7️⃣ Progress Analytics (`/results`)

Data-driven insights with interactive charts:

┌──────────────────────────────────────────────────┐
│ Your Learning Journey                            │
├──────────────────────────────────────────────────┤
│ [Week] [Month] [All Time]                        │
│                                                  │
│ KPI ROW                                          │
│ Avg Score: 78% | Accuracy: 82% | Best: 92%     │
│ Tests: 24       | Streak: 15 days                │
│                                                  │
│ SUBJECT MASTERY                                 │
│ Physics      ████████░░ 85%                     │
│ Chemistry    ██████░░░░ 70%                     │
│ Math         ██████████ 92%                     │
│ Biology      ████░░░░░░ 50%                     │
│                                                  │
│ RECENT TESTS                                    │
│ [Test cards with scores and trends]             │
│                                                  │
└──────────────────────────────────────────────────┘

8️⃣ Achievements (`/achievements`)

Gamification hub with badges and leaderboard:

┌─────────────────────────────────────────────┐
│ Achievements & Badges                       │
├─────────────────────────────────────────────┤
│ Stats: 8 Badges | 2450 XP | Rank #42       │
│                                             │
│ LEADERBOARD                                 │
│ 🥇 1. Ravi Kumar     (⭐⭐⭐) 2450 XP      │
│ 🥈 2. Priya Singh    (⭐⭐⭐) 2210 XP      │
│ 🥉 3. Arjun Patel    (⭐⭐) 1980 XP        │
│ 🔷 You               (⭐⭐) 1650 XP        │
│                                             │
│ BADGE GALLERY                               │
│ ┌──────┐ ┌──────┐ ┌──────┐ ┌──────┐      │
│ │ 🏃   │ │ 🎯   │ │ 📚   │ │ 🧠   │      │
│ │Streak│ │Acc  │ │Persist│ │Master│      │
│ │ ✓    │ │ ✓    │ │  ✓   │ │ ✓    │      │
│ └──────┘ └──────┘ └──────┘ └──────┘      │
│                                             │
└─────────────────────────────────────────────┘

9️⃣ Teacher Panel (`/teacher-panel`)

Comprehensive student monitoring dashboard:

┌──────────────────────────────────────────────────────┐
│ Teacher Dashboard                                    │
├──────────────────────────────────────────────────────┤
│                                                      │
│ KPI CARDS                                           │
│ Active: 24 | Avg Mastery: 78% | At Risk: 3        │
│                                                      │
│ STUDENT ROSTER                                      │
│ Name          │ Status      │ 7-Day Trend          │
│ Anuj Kumar    │ EXCELLENT   │ ↑ +12%               │
│ Priya Singh   │ GOOD        │ → Stable             │
│ Raj Patel     │ STRUGGLING  │ ↓ -8%                │
│ Neha Sharma   │ AT RISK     │ ↓ -15% (Alert)       │
│                                                      │
│ AI ALERTS                                           │
│ 🚨 Neha Sharma: Performance below baseline          │
│    [View Analytics]                                │
│                                                      │
└──────────────────────────────────────────────────────┘

🔟 Settings & Profile

User customization and account management:

Tabs: [Profile] [Account] [Preferences]

PROFILE TAB
Name: Anuj Kumar
Email: anuj@example.com
Role: 🎓 Student | Exam: 🎯 JEE
Class: 12th | Exam Date: 2026-06-15
[Save Changes]

ACCOUNT TAB
Old Password: [ _____________ ]
New Password: [ _____________ ]
Confirm: [ _____________ ]
[Change Password]
[Logout]

PREFERENCES TAB
🌙 Theme: Dark | Light (Toggle)

🌐 Backend API

🔐 Authentication Endpoints (`/api/auth`)

POST /api/auth/register
Request: {email, password, full_name, role, class_level, target_exam}
Response: {user_id, email, role, access_token}
Auth: None

POST /api/auth/login
Request: {email, password}
Response: {access_token, expires_in, user}
Auth: None

GET /api/auth/me
Response: {id, email, full_name, role, profile}
Auth: Bearer token

💬 Chat Endpoints (`/api`)

POST /api/chat
Request: {message, context?, weak_topics?, strong_topics?}
Response: {response, mode: "tutor"}
Auth: None

POST /api/chat/stream
Request: {message, mode: "tutor|feedback|diagnostic"}
Response: Server-Sent Events (text/event-stream)
Auth: None

POST /api/diagnostic
Request: {subject?: "all"}
Response: {questions: [...], total: 10}
Auth: None

📝 Test Endpoints (`/api`)

POST /api/generate-test
Request: {subject, chapter, difficulty, count}
Response: {test_id, questions: [...]}
Auth: None

POST /api/tests/submit
Request: {test_id, responses: [{q_id, selected, time_spent}, ...]}
Response: {score, accuracy, feedback, performance_analysis}
Auth: Bearer token

POST /api/analyze-results
Request: {subject, responses: [...]}
Response: {analysis, gaps, revision_plan}
Auth: Bearer token

GET /api/tests/history
Query: ?limit=10&subject=physics
Response: [{test_id, score, date, subject}, ...]
Auth: Bearer token

🏥 Health Endpoint

GET /health
Response: {status, ollama_connected, model_name, timestamp}

🎨 Design System

Color Palette

PRIMARY COLORS (Sky Blue Theme)
🔵 Primary Blue      #0ea5e9   CTAs, active states
🟣 Purple Secondary  #a855f7   Teacher role, AI recommendations
🟢 Success Green     #10b981   Correct answers, completed tasks
🟡 Warning Yellow    #eab308   Streaks, rewards, alerts
🔴 Danger Red        #ef4444   Errors, at-risk students, wrong answers

Dark Mode Theme Tokens

Token	Value	Usage
bg	#070b14	Page background
bgPanel	#0b121f	Card backgrounds
bgCard	#141d2e	Secondary cards
border	#1e293b	Dividers & borders
text	#ffffff	Primary text
textMuted	#94a3b8	Secondary text
accent	#0ea5e9	Highlights & CTAs

Light Mode Theme Tokens

Token	Value	Usage
bg	#f8fafc (slate-50)	Page background
bgPanel	#ffffff	Card backgrounds
bgCard	#f1f5f9 (slate-100)	Secondary cards
border	#e2e8f0 (slate-200)	Dividers & borders
text	#0f172a (slate-900)	Primary text
textMuted	#64748b (slate-500)	Secondary text
accent	#0ea5e9	Highlights & CTAs

Typography

Heading	Font	Size	Weight
H1	Space Grotesk	2.5rem	800
H2	Space Grotesk	2rem	700
H3	Space Grotesk	1.5rem	700
Body	Inter	1rem	400
Caption	Inter	0.875rem	500

🚀 Getting Started

Prerequisites

✅ Node.js 16+         (for frontend)
✅ Python 3.10+       (for backend)
✅ Ollama 0.1.40+     (for AI engine)
✅ Git                 (for version control)

Backend Setup

# 1. Navigate to backend directory
cd backend

# 2. Create and activate virtual environment
python -m venv venv
source venv/bin/activate          # On Windows: venv\Scripts\activate

# 3. Install dependencies
pip install -r requirements.txt

# 4. Setup environment variables
cp .env.example .env
# Edit .env with your configuration:
# - OLLAMA_BASE_URL=http://localhost:11434
# - MODEL_NAME=gemma3:4b
# - JWT_SECRET=your-secret-key

# 5. Ensure Ollama is running in another terminal
ollama serve

# 6. Pull the Gemma 3 model (if not already pulled)
ollama pull gemma3:4b

# 7. Start FastAPI server
python main.py
# Server will run on http://localhost:8000

Frontend Setup

# 1. Navigate to frontend directory
cd frontend

# 2. Install dependencies
npm install

# 3. Start Vite dev server
npm run dev
# Frontend will run on http://localhost:5173

Verify Installation

# Check backend health
curl http://localhost:8000/health

# Check frontend is served
curl http://localhost:5173

# Test AI integration
curl -X POST http://localhost:8000/api/chat \
  -H "Content-Type: application/json" \
  -d '{"message":"Hello AI"}'

📊 Feature Status

✅ Completed Features

Feature	Status	Component
User Registration (Multi-step)	✅ Complete	RegisterPage.jsx
JWT Authentication	✅ Complete	auth/router.py
Role-based Access Control	✅ Complete	TeacherRoute component
AI Chat (Streaming SSE)	✅ Complete	AiTutorPage.jsx
Voice Input (Web Speech API)	✅ Complete	AiTutorPage.jsx
AI Test Generation	✅ Complete	test_generator.py
NTA-Style Test Interface	✅ Complete	MockTestPage.jsx
AI Post-Test Feedback	✅ Complete	results.py
Test History Persistence	✅ Complete	SQLAlchemy models
Study Path Roadmap	✅ Complete	StudyPathPage.jsx
Progress Analytics	✅ Complete	ProgressPage.jsx
Achievements & Gamification	✅ Complete	AchievementsPage.jsx
Teacher Panel	✅ Complete	TeacherPanelPage.jsx
Dark/Light Theme Toggle	✅ Complete	ThemeContext.jsx
Settings & Profile	✅ Complete	SettingsProfilePage.jsx

👥 Contributors

This project is built with ❤️ by a talented team:

👩‍💻 Supriya	👨‍💻 Rohit
Full Stack Developer	UI/UX & Development Advisor
• Backend Architecture	• Frontend UI Design & Implementation
• FastAPI & Ollama Integration	• React Component Architecture
• Database Design & Optimization	• TailwindCSS Styling & Design System
• AI/LLM Integration	• Feature Advisory & Development Support
• API Development	• User Experience Enhancement
GitHub	Contribute

🤝 Contributing

We welcome contributions! Here's how you can help:

Getting Started

Fork the repository
Clone your fork: git clone https://github.com/YOUR_USERNAME/vision.git
Create a branch: git checkout -b feature/amazing-feature
Make changes and test thoroughly
Commit: git commit -m "Add amazing feature"
Push: git push origin feature/amazing-feature
Open a Pull Request with a clear description

Code Standards

✅ Follow PEP 8 (Python) and ESLint (JavaScript)
✅ Write meaningful commit messages
✅ Add comments for complex logic
✅ Test your changes locally
✅ Update README if adding new features

✨ Project Highlights

Structured and scalable full-stack architecture
AI-powered workflow integration using Ollama
Modern responsive UI with React & TailwindCSS
Optimized API and database performance
Contributor-friendly and modular codebase

Reporting Issues

Use clear, descriptive titles
Describe the issue and expected behavior
Include steps to reproduce (if applicable)
Add screenshots or error logs

📞 Support & Community

📧 Email: i.am.supriya15@gmail.com
🐛 Issues: GitHub Issues
💬 Discussions: GitHub Discussions

📄 License

This project is licensed under the MIT License — see the LICENSE file for details.

MIT License © 2026 Supriya & Rohit
You are free to use, modify, and distribute this software
for personal or commercial purposes.

🙏 Acknowledgments

React & Vite team for amazing frontend tooling
FastAPI for the elegant backend framework
Ollama for enabling local LLM inference
Google Fonts for beautiful typography
TailwindCSS for utility-first styling
All contributors who help improve Vision

Built with ❤️ by Supriya & Rohit for students preparing for JEE & NEET

⭐ Star this repo if you find Vision helpful!

Report Bug • Request Feature • View Code

Last Updated: 2026-05-18 | Status: Active Development 🚀

Name		Name	Last commit message	Last commit date
Latest commit History 11 Commits
backend		backend
frontend		frontend
.gitignore		.gitignore
LICENSE		LICENSE
README.md		README.md

Folders and files

Latest commit

History

Repository files navigation

🎯 Vision — AI-Powered JEE/NEET Tutoring Platform

📋 Table of Contents

🎯 Vision

✨ Key Features

🎓 For Students

👨‍🏫 For Teachers

🏗️ Architecture

System Overview

Data Flow

📁 Project Structure

⚙️ Tech Stack

🎨 Frontend

⚙️ Backend

🤖 AI Engine

💾 Database

🔐 Authentication & Security

Authentication Flow

Security Features

User Roles & Permissions

🤖 AI Integration

Ollama Architecture

AI Modes

Context-Aware Personalization

📱 Frontend Pages

1️⃣ Login Page (/login)

2���⃣ Registration Page (/register)

3️⃣ Dashboard (/dashboard)

4️⃣ AI Tutor (/chat)

5️⃣ Mock Test (/test)

6️⃣ Study Path (/study-path)

7️⃣ Progress Analytics (/results)

8️⃣ Achievements (/achievements)

9️⃣ Teacher Panel (/teacher-panel)

🔟 Settings & Profile

🌐 Backend API

🔐 Authentication Endpoints (/api/auth)

💬 Chat Endpoints (/api)

📝 Test Endpoints (/api)

🏥 Health Endpoint

🎨 Design System

Color Palette

Dark Mode Theme Tokens

Light Mode Theme Tokens

Typography

🚀 Getting Started

Prerequisites

Backend Setup

Frontend Setup

Verify Installation

📊 Feature Status

✅ Completed Features

👥 Contributors

🤝 Contributing

Getting Started

Code Standards

✨ Project Highlights

Reporting Issues

📞 Support & Community

📄 License

🙏 Acknowledgments

Built with ❤️ by Supriya & Rohit for students preparing for JEE & NEET

About

Resources

License

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Uh oh!

Contributors

Uh oh!

Languages

1️⃣ Login Page (`/login`)

2��⃣ Registration Page (`/register`)

3️⃣ Dashboard (`/dashboard`)

4️⃣ AI Tutor (`/chat`)

5️⃣ Mock Test (`/test`)

6️⃣ Study Path (`/study-path`)

7️⃣ Progress Analytics (`/results`)

8️⃣ Achievements (`/achievements`)

9️⃣ Teacher Panel (`/teacher-panel`)

🔐 Authentication Endpoints (`/api/auth`)

💬 Chat Endpoints (`/api`)

📝 Test Endpoints (`/api`)

Packages