Skip to content

NaijaCodeClinician/utme-score-calculator

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
 
 
 
 
 
 
 
 

Repository files navigation

UTME Score Calculator

A command‑line tool that simulates the 2026 UTME score calculation for Nigerian students.
It allows you to select your three subjects (plus compulsory English), enter your raw scores, and instantly see:

  • Your percentage scores per subject
  • Grades (Excellent, Very Good, Good, Poor)
  • Total aggregated score
  • Personalised admission advice

Features

  • ✅ Interactive subject selection (prevents duplicates)
  • ✅ Validates scores against maximum marks (English = 60, others = 40)
  • ✅ Converts raw scores to percentages
  • ✅ Grades and final recommendations
  • ✅ Clear, branded terminal output
  • ✅ Auto‑exit countdown

Future Improvements (Roadmap)

  • 💾 File storage – Save scores to a .csv or .txt file (Chapter 10)
  • 🖥️ GUI version – Build with Tkinter, Kivy, or Flask
  • 📊 Course recommendations – Suggest courses based on score and chosen subjects
  • 🏫 University suggestions – Match score with likely admission cut‑offs
  • 📚 Pre‑defined JAMB subject combinations – For Medicine, Engineering, Law, etc.
  • 🔍 Dictionary refactor – Replace parallel lists with dictionaries for cleaner code

Prerequisites

  • Python 3.6+
  • The custom validation.py module in the same directory or folder with utme_score_calculator.py

How to Run

python utme_score_calculator.py

Example Interaction

===========================================================
==========2026 UTME IMPROVISED SCORE CALCULATOR===========
===========================================================

Input your name: Azubuike

Welcome Azubuike to 2026 UTME IMPROVISED SCORE CALCULATOR...

Select from number 2 - 8, to pick your SECOND subject: 2
PHYSICS has been successfully chosen

...

Contributing

Feel free to fork, open issues, or submit pull requests. All ideas are welcome – especially those that add:

· Nigerian university cut‑off data · JAMB subject combinations · Persistent data storage

License

MIT – use freely, credit appreciated.

Author

Azubuike Ihuomachi Prosper – Medical Aspirant & Self‑taught Python Developer GitHub Profile


Disclaimer: This tool is for practice and motivation only. Always rely on official JAMB results.


About

A Python CLI tool that simulates 2026 UTME score calculation. Select three subjects (plus compulsory English), input raw scores, and get percentage scores, grades, total score, and admission advice. Ideal for Nigerian JAMB candidates.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages