PaperForge

AI-powered question paper generator with intelligent assessment creation.

System Architecture

graph TB
    A[Next.js Frontend] --> B[FastAPI Backend]
    B --> C[PostgreSQL Database]
    B --> D[Redis Cache]
    B --> E[HuggingFace Transformers]
    B --> F[ReportLab PDF Generator]
    
    subgraph "Frontend Layer"
        A
    end
    
    subgraph "Backend Layer"
        B
    end
    
    subgraph "Data Layer"
        C
        D
    end
    
    subgraph "AI Services"
        E
        F
    end
    
    B -->|JWT Auth| G[Authentication Service]
    B -->|CRUD| H[Question Management]
    B -->|ML| I[Paper Generation Engine]
    B -->|PDF| J[Document Service]

Loading

Quick Start

# Backend
pip install -r requirements.txt
uvicorn app.main:app --reload

# Frontend
cd frontend
npm install
npm run dev

Features

• Smart Paper Generation: AI-driven question selection with difficulty balancing
• Professional PDF Output: Customizable, watermarked exam papers
• Role-based Access: Admin, Teacher, and Student permissions
• Modern UI: Responsive Next.js frontend with glass-morphism design
• RESTful API: Comprehensive OpenAPI documentation

Tech Stack

Backend

• FastAPI • PostgreSQL • SQLAlchemy • JWT Auth
• ReportLab • HuggingFace Transformers • scikit-learn

Frontend

• Next.js 14 • React 18 • Tailwind CSS • Framer Motion
• Radix UI • React Hook Form • Zod Validation

API Endpoints

Authentication

• POST /auth/register • POST /auth/login • POST /auth/logout

Questions

• POST /questions/add • GET /questions/list • PUT /questions/update/{id}

Papers

• POST /papers/generate • GET /papers/my-papers • GET /papers/download/{id}

AI

• POST /ai/generate-question • POST /ai/predict-difficulty

Documentation

• API Docs: http://localhost:8000/docs
• Interactive UI: http://localhost:8000/redoc
• Frontend: http://localhost:3000

Deployment

Docker

docker-compose up --build

Environment Variables

DATABASE_URL=postgresql://user:pass@host:5432/db
JWT_SECRET=your_secret_key
USE_AI=true

License

MIT License

---

Built with modern web technologies