Get Started
Run a first handwritten-math-recognizer example
Run a first handwritten-math-recognizer example: Read handwritten digits and arithmetic from a drawing pad, with classroom profiles and grading tools.
Start with the smallest workflow described by the README for handwritten-math-recognizer. Complete installation and configuration first.
First-run instructions
The captured README does not include a runnable quick-start example. Use the linked source reference to identify the public entry point and its prerequisites. Do not assume the repository name is an installable package.
Project Structure
smart-classroom/
├── main.py # Main application
├── app.py # Dashboard app (train / test / camera)
├── draw_pad.py # Drawing pad with digit segmentation
├── retrain_robust.py # Trains models/expr_model.pth
├── generate_tests.py # Deterministic test image generator
├── gen_demo.py # Regenerates the README screenshots
├── config.py # Configuration
├── requirements.txt # Dependencies
├── docs/ # Demo screenshots
├── utils/
│ ├── face_detector.py # Face detection & recognition
│ ├── number_recognizer.py # CNN number recognition
│ └── profile_manager.py # Student profiles & grading
├── models/ # Saved ML models (gitignored)
├── data/ # MNIST + test data (gitignored)
└── profiles/ # Student profile JSONsNext task
Read the usage guide for the documented components, configuration, and source layout.
Source and help
Source captured: 2026-10-11
