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

  1. Download the RC9 Linux .tar.gz archive and matching .sha256 file.
  2. Verify the SHA-256 checksum.
  3. Extract the complete archive.
  4. Keep the grime3 executable and _internal directory 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_64

Start the browser interface

./start-grime3.sh

or simply:

./grime3

With no arguments, the standalone executable starts the browser interface and opens the default browser.

Command line

./grime3 --help
./grime3 measure --help

Measure 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.