GRIME3 0.1.0 RC9 — Linux Standalone Quick Start
The RC9 Linux standalone candidate is a PyInstaller one-folder
distribution packaged as a .tar.gz archive.
It is intended for modern x86_64 Ubuntu/Xubuntu-class Linux systems and does not require Python, Conda, or a Python virtual environment on the target system.
This RC9 format is an evaluated standalone baseline. The longer-term portable Linux format remains subject to portability testing across common Linux distributions.
Install
- Download the RC9 Linux
.tar.gzarchive and matching.sha256file. - Verify the SHA-256 checksum.
- Extract the complete archive.
- Keep the
grime3executable and_internaldirectory together.
Example:
sha256sum -c GRIME3-0.1.0-rc9-linux-x86_64.tar.gz.sha256
tar -xzf GRIME3-0.1.0-rc9-linux-x86_64.tar.gz
cd GRIME3-0.1.0-rc9-linux-x86_64Start the browser interface
./start-grime3.shor simply:
./grime3With no arguments, the standalone executable starts the browser interface and opens the default browser.
Command line
./grime3 --help
./grime3 measure --helpMeasure one image:
./grime3 measure image \
--image "/data/images/image001.jpg" \
--site-config "/data/site/site_config.json" \
--output-dir "/data/results"Measure one folder:
./grime3 measure folder \
--images "/data/images" \
--site-config "/data/site/site_config.json" \
--output-dir "/data/results"Measure a folder of folders:
./grime3 measure folders \
--images-root "/data/campaign" \
--site-config "/data/site/site_config.json" \
--output-dir "/data/results"See CLI_REFERENCE.md for the complete CLI contract.
Provenance
The package contains:
BUILD_INFO.json
PACKAGING_INFO.json
These files identify the exact RC9 source tag, Git commit, build ID, platform, architecture, and distribution type.
Licenses
The package contains:
LICENSE
THIRD_PARTY_NOTICES.md
THIRD_PARTY_LICENSES/
The standalone application uses headless OpenCV 5.0.0, supplied by
the prepared distribution
opencv-python-headless==5.0.0.93+grime3.1. FFmpeg, Qt,
PyTorch and SAM2 are excluded from the supported RC9 Linux runtime.
OPENCV_FFMPEG_FREE.json records the prepared OpenCV
provenance. Preserve it together with the build identity and third-party
license inventory.
Native browsing and saving
Local folder Browse and configuration load/Create/Save As use native system dialogs when available. Cancel keeps the existing path unchanged. Save and Save As require an Operator name as well as a loaded configuration. Choosing a Data Root or Site package folder fills the field; registration is explicit.
The Linux provider requires system GIO/GLib and an active desktop portal with FileChooser version 3 or later. These optional desktop libraries are not bundled. If unavailable, GRIME3 uses its existing browser. Windows validation must run on native Windows, not WSL.
Server conflict and shutdown
Use the exact URL printed by this launcher. An occupied port is
reported as an error. Stop your own GRIME3 launcher with Ctrl+C or
choose another port, for example
web --host 127.0.0.1 --port 8010 --open-browser. Closing a
browser tab does not stop the launcher; stop it in its terminal
window.