Skip to content
Ocean6Documentation
DocsBuild
Reference 0.2Updated 19 Sep 2026

Run the local reference

On this page

Run a complete task on your computer, inspect the result and verify it independently. This path requires no account, wallet or network endpoint. The program uses the Python standard library and performs deterministic line retrieval on a local CPU.

Prerequisites#

The release declares Python 3.9 or later; the recorded release environment is Python 3.12.14. Other versions are not certified by that record. Download the engineering reference from the documentation site and extract it, or use the reference-v0.2 directory in the accompanying documentation package. [E1][E2]

Shell
cd reference-v0.2
python3 reference_runtime.py run task.json result.json receipt.json
python3 reference_runtime.py verify task.json result.json receipt.json
python3 test_reference.py

The first command writes a result and an unsigned receipt. The second recomputes the task and checks the original input and output byte digests. The test command exercises validation and failure conditions. Successful run and verification commands exit with code 0; handled validation or file errors exit with code 1.

Inspect the files#

Swipe or scroll to view all columns →

FileWhat to inspect
task.jsonOperation, input document, search terms and result limit
result.jsonRanked matches, original line numbers and total matching lines
receipt.jsonInput and output digests; local times; signature and settlement are null
task.schema.jsonStructural constraints; runtime checks add further restrictions

The run command overwrites the specified result and receipt files. Use distinct input, result and receipt paths. Keep the original task bytes if you intend to verify the receipt later.

Compare a browser result#

Shell
python3 reference_runtime.py compare task.json browser-result.json

Export the task and result from the local task lab first. compare checks semantic equivalence through Python replay; it does not require a receipt or authenticate the executor. No model inference, GPU execution or remote node operation is exercised by this guide.

Documentation 1.1 · Software reference 0.2
Download PDFDeveloper packageWord editionView Markdown

Search across all 30 chapters.

Use Tab to navigate results and Enter to open a chapter.
Documentation v1.1 · EN
Open task lab ↗Ocean6 website ↗