Installation

Install OpenHarnX from PyPI and the sandbox its checks run in, then check your environment.

OpenHarnX 0.1.1

Install#

shell

# OpenHarnX, pinned to the current release
uv tool install openharnx==0.1.1

# srt, the sandbox every check runs in (needs Node 20 or later)
npm install -g @anthropic-ai/sandbox-runtime@0.0.77

# Check the environment
ohx doctor
ohx --version

uv tool install openharnx without a version installs the latest release. The package is published to PyPI through trusted publishing from the repository's own workflow, with no stored token, and PyPI signs attestations of the files.

ohx doctor checks Python, git and the platform. On a Mac it prints something like:

text

ok    python: 3.12.7 (requires >= 3.12)
ok    git: git version 2.39.5 (Apple Git-154) (/usr/bin/git)
ok    platform: Darwin 25.5.0 arm64

It does not check srt in 0.1.1. If srt is missing, ohx verify --sandbox srt stops with a usage error that says so.

Pin by commit where it matters#

A tag can be moved; a commit cannot. In CI, or anywhere you need to be sure which verifier ran, install from the commit the release notes name:

shell

uv tool install git+https://github.com/rupeshpoojary9/OpenHarnX@2ea714cffcf425d0220d03d5d6802a32707acb05

git ls-remote https://github.com/rupeshpoojary9/OpenHarnX v0.1.1 shows which commit the tag points to.

Upgrade or remove#

shell

uv tool upgrade openharnx
uv tool uninstall openharnx

The evidence store lives in ~/.openharnx (or wherever OHX_HOME points). Uninstalling does not remove it.

Next#

Run the demo to see a gamed test run blocked, or go straight to verifying your first change.