Inspiration

Like every engineering student, I am constantly calculating my attendance to make sure it stays above the strict 75% criteria. Doing the math on how many consecutive classes I need to attend to catch up is a stressful pain point. I wanted to build a simple tool that does the math for me and delivers the news in a relatable, realistic way. What it does You enter your current classes present and total classes held. The app calculates your exact percentage. If you are above 75%, it tells you how many upcoming classes you can safely miss. If you are below 75%, it uses algebra to find the exact number of consecutive classes you must attend to reach eligibility. It then passes this math to the Gemini API, which acts like a senior student giving you personalized advice on your situation. How I built it I am currently learning Python basics through CS50P, so this was my first time building and deploying a real web application. I wrote the core math logic in Python, built the frontend using Streamlit, and integrated the google-genai SDK to generate the conversational text. I hosted the code on GitHub and deployed it live on Streamlit Community Cloud. Challenges I ran into Figuring out the math formula for catching up on attendance was surprisingly tricky, because both the total and present class counts increase at the same time. I also had to learn how to securely manage environment variables, using .gitignore and Streamlit secrets to ensure my API key wasn't exposed to the public. What I learned I learned how reactive web apps work, how to connect a local Python script to a cloud LLM, and how to use Git for version control and deployment. What's next I want to expand the tool so users can input their entire semester schedule and track multiple subjects on a single dashboard.

Built With

Share this project:

Updates

Submission history