Skip to content

imadoszmt/Episteme

Repository files navigation

Episteme Quiz Platform

An interactive quiz platform built with Django that offers programming-related assessments across multiple technical domains. Features real-time feedback, timer functionality, and detailed performance analytics.

Python Django JavaScript HTML CSS Bootstrap

Project Prototype

Here are some preview images of the Episteme prototype:

Episteme Homepage 01

Episteme Homepage 02

Episteme quiz list

Episteme login

✨ Features

  • 📚 Multiple programming quiz categories
  • ⏱️ Interactive quiz timer with real-time updates
  • ✅ Instant feedback on answer submissions
  • 📊 Detailed score reports and performance analytics
  • 👤 User profiles with quiz history
  • 🎯 Progress tracking
  • 🌓 Light/Dark theme support
  • 📱 Responsive design for all devices

🛠️ Technologies

  • Backend: Python 3.8+, Django 4.0+
  • Database: SQLite3
  • Frontend: HTML5, CSS3, JavaScript
  • UI Framework: Bootstrap 5
  • Authentication: Django Allauth

🚀 Quick Installation

  1. Clone the repository

    git clone https://github.com/yourusername/episteme.git
    cd episteme
  2. Create a virtual environment

    python3 -m venv venv
    
  3. Activate the virtual environment

    • On Windows:
      venv\Scripts\activate
      
    • On macOS and Linux:
      source venv/bin/activate
      
  4. Install dependencies

    pip3 install -r requirements.txt
  5. Run migrations

    python3 manage.py migrate
  6. Start the server

    python3 manage.py runserver

Access the application at http://127.0.0.1:8000/

📦 Requirements

Django==4.0.0
django-allauth==0.54.0
django-bootstrap5==23.3
django-environ==0.11.2
django-widget-tweaks==1.5.0
python-dotenv==1.0.0
Pillow==10.0.0

🔑 Key Features

Quiz System

  • Multiple choice questions with instant feedback
  • Real-time quiz timer
  • Detailed results page with answer review
  • Score tracking and analytics

User Management

  • Secure authentication system
  • Personal profile management
  • Quiz history tracking
  • Progress monitoring

📄 License

This project is a prototype developed as part of the ALX Specialization Phase of the Full Stack Software Engineering program.

📫 Contact

Imad Zalmat - [email protected]

Project Link: https://github.com/imadoszmt/Episteme

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published