Skip to main content

Prerequisites

The Maven project targets Java 25 and uses Spring Boot 4.0.5. Use a JDK 25 installation for compilation, tests, and local execution.

Sunbeam also depends on native image and OCR tooling:

  • Tesseract OCR 5.x must be installed and loadable by the host operating system.
  • The working directory must contain a local tessdata/ directory.
  • Provision Vietnamese (vie) and English (eng) trained data as described by the project setup. The current runtime source explicitly configures Tesseract for vie; it does not select eng.
  • JavaCV/OpenCV platform binaries are resolved through Maven dependencies.

For the documented test command, set Java 25 explicitly:

JAVA_HOME=/usr/lib/jvm/java-25-openjdk-amd64 ./mvnw test

No source-backed configuration exists for another Java version, another Tesseract data path, an alternate OCR language, or a different sheet layout.