# Running the example

From the root of this repository, on a Mac (the commands were run on macOS 27.0 with Python 3.14.6):

```bash
python3 -m venv .venv
.venv/bin/pip install -r host/requirements-host.txt
.venv/bin/python examples/run_example.py --check
.venv/bin/python examples/run_example.py --check --accelerator cpu
.venv/bin/python examples/run_example.py --request examples/request.json --image fixtures/images/clock_3oclock_256x240.png --tile 256
```

- `--check` answers four public fixture requests (a SemIf record, a support ticket, a JSON order and a drawn picture) on the GPU at float32 precision (Metal on a Mac), compares them with the provider's own code in float32 on the CPU (`run_example.expected.json`), sends twelve requests the host refuses, and prints one line, `PASS` or `FAIL`. `--accelerator cpu` does the same on the CPU (XNNPACK, 8 threads).
- `--request` answers your own request (a JSON file of the SystemOne-compatible request shape) and prints the response; `--image` adds one picture, read at a 448 px square tile (`--tile 448`, the default) or a 256 px one.
- A graph is compiled the first time a request needs it: on the GPU that takes one to three minutes per row graph. One process keeps one row graph at a time; a request of another length closes it and compiles the next.
- A request the host refuses prints `refused: <error>: <message>` and exits with code 3.