---
title: Class Schedule Generator V2
emoji: 🦀
colorFrom: blue
colorTo: red
sdk: gradio
sdk_version: 5.42.0
app_file: app.py
python_version: 3.10.13
pinned: false
---

# 📅 Class Schedule Generator

A sleek, interactive Gradio app that generates **three different weekly class schedules** based on your preferences.  
Built for a data science project — using a fully **embedded synthetic dataset** of 1,000 college classes across 10 subjects.

---

## ✨ Features

- **Subject selection** – Choose from 10 subjects via dropdown  
- **Custom counts** – Specify how many classes per subject you want  
- **Total tracker** – Live update of total class count  
- **Custom instructions** – Add constraints like:
  - `Don't give me classes on Sundays`
  - `No classes before 10 AM`
  - `No classes after 6 PM`
- **Three schedule options** – AI picks non-conflicting classes that fit your rules
- **Weekly timetable view** – Color-coded blocks for each class  
- **Navigation** – "Previous" and "Next" buttons to flip between schedules  
- **Full class details** – Click to see all info (professor, time, days, subject)

---

## 🛠 Dataset

The dataset is **embedded directly into the app** (no external file required).

- **10 subjects**: Computer Science, Mathematics, Economics, Psychology, Biology, Chemistry, Physics, Art History, Philosophy, Finance
- **100 classes per subject** (1,000 total)
- Each record includes:
  - `class_id`
  - `name`
  - `professor`
  - `days` (Sunday–Friday)
  - `times` (8 AM–8 PM)
  - `subject`

---

## 🚀 Running Locally

1. **Clone this repository** or download the files
2. Install dependencies:
   ```bash
   pip install -r requirements_inline.txt