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
- Download the complete RC9 Windows ZIP and its
.sha256file. - Verify the ZIP SHA-256 checksum.
- Extract the entire ZIP to a normal local folder.
- Keep
GRIME3.exeand the_internaldirectory 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.