README.md

metadata

title: Minerva Lite
emoji: 📝
colorFrom: blue
colorTo: green
sdk: docker
app_file: app.py
pinned: false

Minerva Lite: Registration

Minerva Lite is a simplified web-based simulation of course registration. It is designed for demonstration, testing and educational purposes.

Demo Video

Watch demo

Demo

• Online demo (Hugging Face): https://huggingface.co/spaces/Yuj7/minerva-lite
• Docker image (Docker Hub): https://hub.docker.com/r/yujc7/minerva-lite

Run with Docker

docker run --rm -p 7860:7860 yujc7/minerva-lite:latest

Key Features

• Term Selection:

  • Choose from multiple academic terms (Fall 2025, Winter 2026, Summer 2026)

• Course Search:

  • Search for courses by subject, number, title, or campus
  • View available courses for the selected term, including seat availability and schedule details

• Add/Drop Courses:

  • Register for courses by entering a CRN (Course Reference Number)
  • Drop registered courses

• Student Schedule:

  • View your current course registrations for the selected term
  • See a weekly grid view of your schedule, with time blocks for each class

• Accounts:

  • View a placeholder page for tuition fee and legal status (for demonstration).

• Database Reset:

  • Use the /reset endpoint to reseed the database with demo data (useful for testing or restoring the initial state).

Demo Data

• The app comes preloaded with a variety of courses across multiple terms and departments (COMP, MATH, PHYS, ECON, ENGL, etc.).
• Each course includes details such as subject, number, title, credits, days, time, campus, and seat availability.

Intended Use

• This app is for demonstration and educational purposes only.
• No real student data is used or stored.

How to Use

1. Select a term to begin.
2. Search for courses or browse available options.
3. Add or drop courses using CRNs.
4. View your schedule in list or weekly grid format.
5. Reset the database if you want to restore the original demo data.