Download

K-Veritas CLI

One static binary. No dependencies. Any language.

uv or pip

The same binary, installed into your Python tools. No Python package to import.

bash
uv tool install kveritas --find-links https://27-group.github.io/kveritas-releases/wheels/
pip install kveritas --find-links https://27-group.github.io/kveritas-releases/wheels/

Install via command line

Downloads the CLI and puts it on your PATH. kveritas update keeps it current. Old versions cannot start new sessions.

Linuxx86_64 (amd64)
curl -fsSL https://github.com/27-GROUP/kveritas-releases/raw/main/bin/kveritas-linux-amd64 -o kveritas
chmod +x kveritas && sudo mv kveritas /usr/local/bin/
LinuxARM64
curl -fsSL https://github.com/27-GROUP/kveritas-releases/raw/main/bin/kveritas-linux-arm64 -o kveritas
chmod +x kveritas && sudo mv kveritas /usr/local/bin/
macOSApple Silicon (arm64)
curl -fsSL https://github.com/27-GROUP/kveritas-releases/raw/main/bin/kveritas-darwin-arm64 -o kveritas
chmod +x kveritas && sudo mv kveritas /usr/local/bin/
macOSIntel (amd64)
curl -fsSL https://github.com/27-GROUP/kveritas-releases/raw/main/bin/kveritas-darwin-amd64 -o kveritas
chmod +x kveritas && sudo mv kveritas /usr/local/bin/
Windowsx86_64 (PowerShell)
Invoke-WebRequest -Uri "https://github.com/27-GROUP/kveritas-releases/raw/main/bin/kveritas-windows-amd64.exe" -OutFile "kveritas.exe"

CLI binary

Direct downloads. Checksums in SHA256SUMS.

Linuxx86_64 (amd64)kveritas-linux-amd64
macOSApple Silicon (arm64)kveritas-darwin-arm64
macOSIntel (amd64)kveritas-darwin-amd64
Windowsx86_64 (amd64)kveritas-windows-amd64.exe

Attestation server (self-hosted)

Optional. The CLI uses the hosted K-Veritas server by default. Reports signed by your own server verify as SELF-ATTESTED, not VERIFIED.

Linuxx86_64 (amd64)kveritas-server-linux-amd64
macOSApple Silicon (arm64)kveritas-server-darwin-arm64

Check the installation

terminal
$ kveritas version
kveritas <date-based version> (linux/amd64, go1.22.5, commit <hash>)

$ kveritas --help

Available Commands:
  agent                Record an AI agent from outside: every process, file change and connection (Linux)
  autolog              Find results in output and metric files when a run prints no KV lines
  branch               List branches, or start or switch to one
  check                Check paper claims against a signed report
  checkout             Reconstruct the files of a snapshot from a checkout bundle
  checkpoint           Save the project's files as a point you can come back to
  clean                Remove the .kveritas session directory
  completion           Generate the autocompletion script for the specified shell
  generate-claims      Generate a claims.json template from a signed report
  hardware             Show the CPU, memory and GPUs K-Veritas detects
  harness-prove        Prove a recorded prompt or output was in a signed agent session
  help                 Help about any command
  init                 Initialize a K-Veritas session in the current directory
  key                  This machine's signer key and the sessions started with it
  log                  Show the session's history as a tree: runs, checkpoints, branches
  prove                Prove one or more files were part of a signed snapshot, revealing nothing else
  record               Append a designated agent action to the harness session chain
  restore              Put the project's files back as they were at a checkpoint
  run                  Run a monitored experiment
  seal                 Bundle and cryptographically sign the session; produce a PDF report
  set-aside            Move a run out of the main results, keeping it in the report
  shell                Open a recorded terminal: every command becomes a run
  status               Show your branch, the files changed since the checkpoint, and the session
  update               Update kveritas to the latest version
  verify               Verify a signed K-Veritas report (offline checks plus the full server audit)
  verify-harness-proof Check a harness prompt/output proof
  verify-proof         Check a selective-disclosure proof
  version              Show the kveritas version
  web                  Open the session's history in your browser

Seal output (open disclosure):
  report.pdf                 Signed PDF report
  report.pdf.kvbundle.zip    Code bundle, its hash bound into the signature
  report.pdf.provkey.json    Local keystore for proofs; keep it private