Every semester, my college friend and I face the exact same chaos before our exams: piles of slides and notes, scanned PDFs, previous-year papers, syllabi, and only a few hours left.
When you're pulling a deadline all-nighter, reading through hundreds of slides line-by-line is impossible. Asking a standard LLM often leads to generic fluff or hallucinated answers with zero references.
That's why I built Deadline Guardian, a RAG-based project for the DEV Hacktoberfest Weekend Challenge — "Build for a Friend"!
We can all work together on this project to improve this small Deadline Guardian for all of us!
[ch4.pptx p.11].
GitHub Repository:
https://github.com/Masham-0/deadline-guardian
Live Demo:
https://deadline-guardian-3195.onrender.com/
git clone https://github.com/Masham-0/deadline-guardian.git
cd deadline-guardian
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
Create a .env file:
LLM_BASE_URL=https://generativelanguage.googleapis.com/v1beta/openai/
LLM_API_KEY=your_api_key_here
LLM_MODEL=gemma-2-9b-it
For the Google API setup:
uvicorn main:app --reload --host 127.0.0.1 --port 8000
For a local Ollama setup:
ollama pull gemma:2b
Then start the server with:
LLM_BASE_URL=http://localhost:11434/v1 \
LLM_API_KEY=ollama \
LLM_MODEL=gemma:2b \
uvicorn main:app --reload
Developer: Mohammad Masham
Email: mohd.masham@gmail.com
Institution: Netaji Subhas University of Technology (NSUT)
Hackathon: DEV Hacktoberfest Weekend Challenge 2026 — Build for a Friend
If you find Deadline Guardian helpful for your exam prep, feel free to drop a ⭐ on the GitHub repository!
Happy studying! 📚