# GRIME3 0.1.0 RC8.4 — Linux Standalone Quick Start

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

```bash
sha256sum -c GRIME3-0.1.0-rc8.4-linux-x86_64.tar.gz.sha256
tar -xzf GRIME3-0.1.0-rc8.4-linux-x86_64.tar.gz
cd GRIME3-0.1.0-rc8.4-linux-x86_64
```

## Start the browser interface

```bash
./start-grime3.sh
```

or simply:

```bash
./grime3
```

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

## Command line

```bash
./grime3 --help
./grime3 measure --help
```

Measure one image:

```bash
./grime3 measure image \
  --image "/data/images/image001.jpg" \
  --site-config "/data/site/site_config.json" \
  --output-dir "/data/results"
```

Measure one folder:

```bash
./grime3 measure folder \
  --images "/data/images" \
  --site-config "/data/site/site_config.json" \
  --output-dir "/data/results"
```

Measure a folder of folders:

```bash
./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:

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

These files identify the exact RC8.4 source tag, Git commit, build ID,
platform, architecture, and distribution type.

## Licenses

The package contains:

```text
LICENSE
THIRD_PARTY_NOTICES.md
THIRD_PARTY_LICENSES/
```

The standalone application uses headless OpenCV. Qt, PyTorch, and SAM2
are not part of the supported RC8.4 Linux standalone runtime.