Made with <3 by:

Each user uploads their calendar. The system analyses users' calendars to rank potential matches based on predicted times when they are on-campus at the same time as you. When you view someone's profile, you can see the potential opportunities to meet them based on your calendar.

.

This project was created as a part of UNSW DevSoc's HACKaByte hackathon in March 2025.

The project has not been updated since then, and so likely has numerous security vulnerabilities. Unless you intend on updating all the dependencies, you should not run this in production.

Copyright © Raising Elephants, 2025. You may not use this project for any purposes without permission from the authors.

We're using uv as a package manager.

Create a file .env, with contents adapted from the following

# Enable dev mode
FIRSTMATE_DEV=true
# Secret used for encrypting session cookie
FIRSTMATE_SECRET="your complex secret"
# Data directory path
FIRSTMATE_DATA="."

uv sync

uv run basedpyright

uv run -m first_mate

Easiest with Docker Compose. Data file can't be written unless it was created before the container starts. I don't know why, and I want to sleep, so I'll troubleshoot some other time.