GradeScope

GradeScope is a local academic dashboard for tracking academic progress in one place instead of jumping across portal pages and losing context.

It combines a FastAPI backend, a React/Vite frontend, and a portal sync flow that collects attendance, marks, GPA, and dashboard data.

Start

start-all.bat

On a fresh download, start-all.bat creates the Python virtual environment, installs backend dependencies, installs frontend dependencies, and downloads Playwright Chromium before starting the app. If setup fails, the launcher keeps the window open so the error can be read.

Open:

http://127.0.0.1:5173

Backend:

http://127.0.0.1:8000

Sync

POST /api/sync opens the portal login flow. Log in manually; GradeScope continues once login is detected.

The sync browser blocks unnecessary assets and saves only the HTML/text needed for parsing.

Playwright needs a separate Chromium browser download in addition to the Python package. start-all.bat checks this automatically, and /api/sync also runs the same check before opening the portal browser. If you ever need to repair it manually, run:

.\.venv\Scripts\python.exe -m playwright install chromium

API

GET  /api/status
GET  /api/dashboard
GET  /api/attendance
GET  /api/marks
GET  /api/gpa
GET  /api/gpa-courses
GET  /api/raw-notes
POST /api/sync
POST /api/clear-data

Data

backend/data/raw/
backend/data/summaries/
backend/data/processed/