Skip to main content

Sunbeam

Sunbeam is a Spring Boot service that reads marked exam sheets, extracts the selected answers, reads the name and class regions with Tesseract, and compares the answers with a CSV answer key.

The service accepts one image and one answer-key file at POST /api/v1/grade. Its current implementation is built around a fixed 40-question sheet layout with four choices per question. Start with the prerequisites, then run the quick start.

What this documentation covers​

  • Local installation with Java 25, Maven, Tesseract 5.x, and tessdata.
  • The actual multipart request and GradeResult response shape.
  • The fixed alignment, OMR, OCR, and debug-output behavior in the Java services.
  • Test fixtures and the limits that are not established by the source.

Sunbeam does not currently document authentication, upload limits, configurable layouts, production OCR accuracy, concurrency guarantees, or debug-file retention as supported properties.