QPP Pro — AI Question Paper Generator

AI-powered intelligent examination paper generation platform built using FastAPI, semantic retrieval pipelines, analytics, optimization engines, and PDF export support.

---

Overview

QPP Pro is a modular AI-assisted examination paper generation system designed to automate intelligent question paper creation for academic institutions.

The platform supports:

• AI-assisted paper generation
• difficulty balancing
• syllabus/topic based generation
• analytics and insights
• PDF export
• dataset upload
• semantic retrieval pipelines

The system was designed with a scalable backend architecture using FastAPI and layered service/repository patterns.

---

Screenshots

Landing Page

Login System

Dashboard

---

Features

• AI-powered question paper generation
• Difficulty-based optimization
• MCQ / Short / Long question balancing
• Dataset upload support
• Semantic topic retrieval
• Analytics dashboard
• PDF export generation
• Modular API architecture
• Real-time generation pipeline
• Intelligent paper structuring

---

System Architecture

Frontend UI
    ↓
FastAPI Backend
    ↓
API Layer
    ↓
Generation Engine
    ↓
Scoring Engine
    ↓
Optimization Layer
    ↓
PDF Export + Analytics

# Backend Architecture

```text
app/
├── api/
│   ├── ai_generate.py
│   ├── auth.py
│   ├── generate.py
│   ├── pdf.py
│   ├── subjects.py
│   ├── units.py
│   └── upload.py
│
├── core/
│   └── database.py
│
├── models/
│   ├── paper.py
│   ├── paper_question.py
│   ├── question.py
│   └── user.py
│
├── repositories/
│   ├── paper_repo.py
│   └── question_repo.py
│
├── schemas/
│   └── paper.py
│
├── services/
│   ├── ai/
│   │   ├── embedding_engine.py
│   │   └── retriever.py
│   │
│   ├── generator/
│   │   ├── constraint_engine.py
│   │   ├── generator_engine.py
│   │   ├── nlp_engine.py
│   │   ├── optimizer.py
│   │   └── scoring_engine.py
│   │
│   ├── analytics.py
│   └── pdf_service.py
│
├── static/
│   ├── css/
│   └── js/
│
└── templates/
    ├── dashboard.html
    ├── home.html
    └── login.html

# Tech Stack

## Backend
- FastAPI
- SQLAlchemy
- Python

## AI / NLP
- Sentence Transformers
- Semantic Retrieval
- Embedding Pipelines

## Frontend
- HTML
- CSS
- JavaScript

## Database
- SQLite

## PDF Engine
- ReportLab

---

# Core Modules

## AI Generation Engine
Implements intelligent paper generation using topic analysis, retrieval pipelines, and optimization logic.

## Scoring Engine
Balances question complexity and difficulty distribution across generated papers.

## Retrieval Engine
Uses semantic similarity and embeddings for topic-aware question selection.

## Analytics Module
Provides generation insights and paper statistics.

## PDF Service
Exports generated papers into printable PDF formats.

---

# Installation

## Clone Repository

```bash
git clone https://github.com/thatiswat/QPP-Pro.git

## Navigate Into Project

```bash
cd QPP-Pro

---

Create Virtual Environment

python3 -m venv venv

---

Activate Environment

macOS/Linux

source venv/bin/activate

---

Install Dependencies

pip install -r requirements.txt

---

Run Server

python3 -m uvicorn app.main:app --reload

---

Access Application

http://127.0.0.1:8000

---

Future Improvements

• Transformer fine-tuning
• Adaptive paper balancing
• Multi-user authentication
• Cloud deployment
• Docker support
• Advanced analytics dashboard
• Institutional integration
• AI-based plagiarism checks

---

Project Highlights

• Modular FastAPI architecture
• AI-assisted generation pipeline
• Semantic retrieval implementation
• Clean dashboard UI
• Layered backend engineering
• Intelligent optimization logic

---

Author

Vishal S

AI Systems • Backend Engineering • Embedded Systems

---

License

This project is intended for academic and educational purposes.