GRIME3 0.1.0 RC9 — Windows Quick Start

GRIME3 RC9 is distributed as a Windows x64 PyInstaller one-folder ZIP. Python, Conda, and development tools are not required to run the ZIP.

Install

  1. Download the complete RC9 Windows ZIP and its .sha256 file.
  2. Verify the ZIP SHA-256 checksum.
  3. Extract the entire ZIP to a normal local folder.
  4. Keep GRIME3.exe and the _internal directory together.

Do not run GRIME3.exe directly from inside the ZIP.

Start the browser interface

Double-click:

START_GRIME3.bat

or double-click:

GRIME3.exe

With no command-line arguments, GRIME3.exe starts the browser server and opens the browser.

The default local address is:

http://127.0.0.1:8000/

Use the command line

Open Command Prompt or PowerShell in the extracted GRIME3 folder.

Show help:

GRIME3.exe --help

Show measurement commands:

GRIME3.exe measure --help

Measure one image:

GRIME3.exe measure image ^
  --image "C:\Data\Images\image001.jpg" ^
  --site-config "C:\Data\Site\site_config.json" ^
  --output-dir "C:\Data\Results"

Measure one folder:

GRIME3.exe measure folder ^
  --images "C:\Data\Images" ^
  --site-config "C:\Data\Site\site_config.json" ^
  --output-dir "C:\Data\Results"

Measure a folder of folders:

GRIME3.exe measure folders ^
  --images-root "C:\Data\Campaign" ^
  --site-config "C:\Data\Site\site_config.json" ^
  --output-dir "C:\Data\Results"

Paths containing spaces should be quoted.

See CLI_REFERENCE.md for the complete CLI contract.

Windows security warning

RC9 is research/evaluation software and is not code-signed. Windows SmartScreen may display a warning for a downloaded executable.

Verify the ZIP filename and SHA-256 checksum before running it.

Package provenance

The extracted package contains:

BUILD_INFO.json
PACKAGING_INFO.json

BUILD_INFO.json records the exact GRIME3 Git commit, RC9 Git tag, build identifier, build time, architecture, and distribution identity.

Runtime identity

The complete package supplies its Python runtime and headless OpenCV 5.0.0. The prepared OpenCV distribution is opencv-python-headless==5.0.0.93+grime3.1; FFmpeg is excluded. Keep OPENCV_FFMPEG_FREE.json, BUILD_INFO.json and the license inventory with the extracted application. Use the complete package rather than replacing individual DLLs or installing a stock OpenCV wheel.

Licenses

The package contains:

LICENSE
THIRD_PARTY_NOTICES.md
THIRD_PARTY_LICENSES\

The third-party directory contains package-license records and native runtime notices/licenses collected from the actual Windows build environment.

Stop a command-line run

For folder processing, the first Ctrl+C requests a cooperative stop. GRIME3 finishes the current image, finalizes completed output, and exits with interrupted status.

A second Ctrl+C forces immediate interruption.

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.