How wongcyrus/ai-handwrite-grader works
AI-Handwriting-Grader is an educator-led workflow for preparing scanned assignments, grading question by question in a local web interface, and producing and returning scored work. The README documents the notebook stages; sampled source confirms the Flask marking server and browser-side mark/control persistence. Notebook implementation was not sampled, so those links reflect the documented workflow rather than inspected calls.
Main entry points: server.py Flask marking server · email_score.ipynb Email delivery · scoring_preprocessing.ipynb Scoring preparation · templates Marking website
Components 16
Assignment preparation
- Scanned scripts
data - Class and answers
NamelistAndAnswerTemplate.xlsx - Question annotations
notebbooks/question_annotations.ipynb - Scoring preparation
notebbooks/scoring_preprocessing.ipynb
Marking workflow
- Marking website
templates - Question view
templates/questions/question.js - Mark and controls
templates/javascript/common.js - Flask marking server
server.py - Saved marks
data
Reporting and return
- Post-validation
notebbooks/scoring_preprocessing.ipynb - Score reports
notebbooks/scoring_postporcessing.ipynb - Annotated scripts
data - Email delivery
notebbooks/email_score.ipynb
Other components
- Educator
- Students
- Gmail SMTP
Connections 19
- Educator → Scanned scripts: uploads scans
README.md - Educator → Class and answers: prepares roster
README.md - Scanned scripts → Question annotations: annotates questions
README.md - Class and answers → Scoring preparation: provides answers
README.md - Question annotations → Scoring preparation: prepares scoring
README.md - Scoring preparation → Marking website: generates website
README.md - Educator → Flask marking server: starts server
README.md - Flask marking server → Marking website: serves pages
server.py - Marking website → Question view: renders questions
- Educator → Mark and controls: enters marks
templates/javascript/common.js - Mark and controls → Flask marking server: posts mark data
templates/javascript/common.js - Flask marking server → Saved marks: writes JSON
server.py - Educator → Post-validation: checks missing answers
README.md - Saved marks → Post-validation: validates saved marks
- Educator → Score reports: generates results
README.md - Score reports → Annotated scripts: creates annotated work
README.md - Educator → Email delivery: sends scripts
README.md - Email delivery → Students: returns scripts
README.md - Email delivery → Gmail SMTP: uses mail service
README.md