📊 VIT-GPA-Calculator - Simulate Grade Improvements & Plan Future Semesters!

Hey! 👋

I made a Python tool to help you manage your GPA: VIT-GPA-Calculator. It extracts data from your VTOP Grade History PDF, calculates your CGPA, and lets you simulate grade improvements and plan future courses.

Key Features:

  • Data Extraction: Pulls your course data directly from your VTOP Grade History PDF.
  • CGPA Calculation: Calculates your current CGPA.
  • Grade Distribution: Shows credits earned per grade.
  • Grade Improvement Simulation: See how improving specific grades impacts your CGPA.
  • Future Courses Simulation: Plan upcoming semesters and see your projected CGPA.
  • Target CGPA Planning: Calculates the average grade needed to reach a target CGPA.
  • Visualization (Advanced Version): main_advanced.py uses the Rich library for a nicer UI, including grade history and distribution charts.

Two Versions:

  1. main.py: Basic console version.
  2. main_advanced.py: Enhanced, interactive UI (recommended!).

How to Use:

  1. Clone: git clone https://github.com/Kaos599/VIT-GPA-Calculator.git and cd into the directory.
  2. Install: Create a virtual environment (python -m venv venv), activate it, and pip install -r requirements.txt.
  3. Install Ghostscript: Required for PDF extraction (Ghostscript Downloads).
  4. Download your Grade History PDF from VTOP.
  5. Run: python main.py (basic) or python main_advanced.py (advanced).
  6. Follow the prompts!

GitHub: https://github.com/Kaos599/VIT-GPA-Calculator

Try it out and let me know what you think! Feedback, bug reports, and contributions are welcome on GitHub. Good luck! 😄

Hey! 👋

I made a Python tool to help you manage your GPA: VIT-GPA-Calculator. It extracts data from your VTOP Grade History PDF, calculates your CGPA, and lets you simulate grade improvements and plan future courses.

Key Features:

  • Data Extraction: Pulls your course data directly from your VTOP Grade History PDF.
  • CGPA Calculation: Calculates your current CGPA.
  • Grade Distribution: Shows credits earned per grade.
  • Grade Improvement Simulation: See how improving specific grades impacts your CGPA.
  • Future Courses Simulation: Plan upcoming semesters and see your projected CGPA.
  • Target CGPA Planning: Calculates the average grade needed to reach a target CGPA.
  • Visualization (Advanced Version): main_advanced.py uses the Rich library for a nicer UI, including grade history and distribution charts.

Two Versions:

  1. main.py: Basic console version.
  2. main_advanced.py: Enhanced, interactive UI (recommended!).

How to Use:

  1. Clone: git clone https://github.com/Kaos599/VIT-GPA-Calculator.git and cd into the directory.
  2. Install: Create a virtual environment (python -m venv venv), activate it, and pip install -r requirements.txt.
  3. Install Ghostscript: Required for PDF extraction (Ghostscript Downloads).
  4. Download your Grade History PDF from VTOP.
  5. Run: python main.py (basic) or python main_advanced.py (advanced).
  6. Follow the prompts!

GitHub: https://github.com/Kaos599/VIT-GPA-Calculator

Try it out and let me know what you think! Feedback, bug reports, and contributions are welcome on GitHub. Good luck! 😄