# GRIME3 0.1.0 RC8.4 — Windows Quick Start

GRIME3 RC8.4 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 RC8.4 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:

```text
START_GRIME3.bat
```

or double-click:

```text
GRIME3.exe
```

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

The default local address is:

```text
http://127.0.0.1:8000/
```

## Use the command line

Open Command Prompt or PowerShell in the extracted GRIME3 folder.

Show help:

```text
GRIME3.exe --help
```

Show measurement commands:

```text
GRIME3.exe measure --help
```

Measure one image:

```text
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:

```text
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:

```text
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

RC8.4 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:

```text
BUILD_INFO.json
PACKAGING_INFO.json
```

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

## Licenses

The package contains:

```text
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.