unisched 0.1.1

An exam scheduler application built with Python, designed to optimize exam schedules at university level.

Unisched - Extensible University Exam Scheduler

---

This is my (Adheesh Trivedi's) submission for the course "Advanced Programming".

Unisched is a basic, modular exam scheduling project that currently supports:

• Registration data loading from CSV, Excel and ODS
• Exam hall data loading from CSV, Excel and ODS
• Core scheduling using a graph coloring optimizer (DSatur-based)
• Conflict-aware schedule generation with simple penalty calculation
• A native-desktop GUI built with PySide6

The project is intentionally minimal and designed to be extended over time.

Installation

From PyPI

pip install unisched

# Then run the app
python -m unisched

It's recommended to use pipx for better dependency resolution:

pipx install unisched

# Then run the app
unisched

Running from source

• Python 3.12
• uv package manager

Dependencies used by the project:

• pandas
• PySide6
• openpyxl
• odfpy

Install dependencies:

uv sync

Run the GUI app:

uv run unisched

Running Tests

Run all tests:

uv sync --extra dev
uv run pytest

Example Script

Run the sample scheduling script:

uv sync --extra example
uv run python examples/schedule.py

TODOs

• Current optimizer implementation: GraphColoringOptimizer only
• Future optimizers (for later): Simulated Annealing, ILP
• Needs a cute logo for the GUI :)