This is a submission for the Hacktoberfest Weekend Challenge: Build for a Friend 🎃
My friend is constantly doing mental gymnastics every morning: "If I skip OS today but my friend marks proxy, can I still afford to bunk Physics tomorrow without falling below 75%?"
The math is stressful, the stakes are high, and honestly, they just wanted to know if they could sleep in.
So for this weekend challenge, I built them ShouldISkipClass.ai—a 100% local, privacy-first AI web app that acts as their personal (and brutally honest) attendance advisor. It takes their schedule, calculates the risks, and tells them exactly what to do.
My friend was completely against typing their terrible grades and attendance records into ChatGPT. Student data is personal!
That’s why I chose to build this using Gemma 3 (4B) running locally via Ollama.
The stack is super lightweight:
Instead of writing complex if/else statements for every possible scenario, the frontend collects the context (current attendance, teacher strictness, proxy availability, and their full day's timetable) and passes it to Flask.
Flask then sends a highly specific system prompt to the local Gemma model. Gemma acts as the advisor, looking for massive schedule gaps or "sleep tax" morning classes, and returns a strict JSON response with a verdict (SAFE TO SKIP, ATTEND, or RISKY SKIP), a risk score out of 10, and witty practical tips.
The hardest part was actually getting the LLM to output consistent JSON without wrapping it in markdown code blocks! I had to tweak the system prompt heavily to force Gemma to behave exactly as a structured API response.
I also spent a lot of time polishing the frontend UI to ensure there was zero scrolling required. We wanted a dashboard that felt like a command center for bunking classes.
The project is fully open-source and I’m actively looking for contributors for Hacktoberfest!
🔗 GitHub Repository:
An open-source AI-powered college attendance advisor that runs 100% locally.
Built with Gemma (Google's open-weight model) via Ollama — your academic data never leaves your machine.
Tell it your attendance percentage, teacher strictness, upcoming tests, and more — and it uses Gemma (running locally via Ollama) to analyze whether you can safely skip your next class.
Features:
| Closed API | Our Approach |
|---|---|
| Your grades sent to corporate servers | Everything stays on YOUR laptop |
| $20/month API costs | 100% free to run |
| Can't customize |
If you want to run it yourself, just install Python and Ollama, run ollama pull gemma3:4b, and ask the AI if you should skip your next lecture! Happy hacking! 💻🎓