prabhat9801/fastapi_mcq_platform repository overview

⁠🎯 Smart MCQ Platform

AI-powered Multiple Choice Question platform built with FastAPI for automated test creation and student assessment.

⁠🚀 Quick Start

# Pull and run the latest image
docker pull prabhat9801/fastapi_mcq_platform:latest
docker run -p 8000:8000 prabhat9801/fastapi_mcq_platform:latest

# Access the application
# API Documentation: http://localhost:8000/docs
# Admin Panel: http://localhost:8000/admin
# Health Check: http://localhost:8000/health

⁠⚙️ Environment Variables

docker run -p 8000:8000 \
  -e GOOGLE_API_KEY="your-api-key" \
  -e SECRET_KEY="your-secret-key" \
  -e DATABASE_URL="sqlite:///./mcq_platform.db" \
  prabhat9801/fastapi_mcq_platform:latest

⁠🌟 Key Features

• 🤖 AI-Powered MCQ Generation - LLM-based question creation from documents
• 🌐 Multi-Language Support - Hindi/English with native script support
• 📊 Real-time Analytics - Performance tracking and progress monitoring
• 🔐 Authentication & Roles - JWT-based security with admin/student roles
• 💳 Payment Integration - Stripe/Razorpay for subscriptions
• 📱 RESTful APIs - 25+ endpoints with OpenAPI documentation

⁠🛠️ Tech Stack

• FastAPI - High-performance async web framework
• LangChain - LLM orchestration and prompt engineering
• ChromaDB + CLIP - Vector database for semantic search
• SQLAlchemy - Database ORM with async support
• Redis - Caching and session management
• Docker - Containerized deployment

⁠📖 Documentation

• GitHub Repository: https://github.com/Prabhat9801/Fastapi-mcq-platform⁠
• API Documentation: Interactive Swagger UI at /docs
• Health Monitoring: Built-in health checks at /health

⁠🔧 Docker Compose (Recommended)

version: '3.8'
services:
  app:
    image: prabhat9801/fastapi_mcq_platform:latest
    ports:
      - "8000:8000"
    environment:
      - SECRET_KEY=your-secret-key
      - GOOGLE_API_KEY=your-api-key
      - DATABASE_URL=sqlite:///./data/mcq_platform.db
    volumes:
      - ./data:/app/data
    restart: unless-stopped

⁠📊 Image Details

• Base Image: python:3.11-slim
• Working Directory: /app
• Exposed Port: 8000
• Health Check: Built-in endpoint monitoring
• Size: Optimized for production deployment

⁠🎯 Use Cases

• Educational institutions for automated exam creation
• Corporate training and assessment platforms
• Online learning platforms requiring API integration
• Content creators needing rapid MCQ generation

⁠🚀 Production Deployment

Suitable for cloud deployment on:

• AWS ECS/EKS
• Google Cloud Run
• Azure Container Instances
• DigitalOcean App Platform
• Any Docker-compatible hosting

⁠🔗 Links

• Repository: https://github.com/Prabhat9801/Fastapi-mcq-platform⁠
• Issues: Report bugs or request features
• Discussions: Community support and questions

Tags: fastapi python ai education mcq llm docker api langchain chromadb