Skip to main content

Etalon documentation

Etalon is an open-source runner. It executes a versioned pack against an OpenAI-compatible endpoint on the operator’s network and writes qualification evidence for that deployment: a fingerprint, captured inputs and outputs, case results, coverage, a three-state decision, and a static HTML report. This repository is the open-source runner, coyos-ai/etalon. The packs checked in here are public fixtures only. A decision is the pack policy reading the scores for the captured configuration. It does not determine that a regulation, contract, or internal control has been met. Published at docs.etalon.sh.

Read in this order

  1. Getting started — install, run the local fixture, open the report, then inspect, verify, and check the bundle.
  2. How qualification works — pack versus runner, what a bundle contains, and how a decision is reached.
  3. CLI reference — subcommands and flags.

Reference

  • Packs — what a pack is, and the two public fixtures.
  • Judges — rubric-judge transports. The TypeSafe transport is TypeSafe judge.
  • Offline install — install from a local wheelhouse with the network namespace disabled.
  • Signing — Ed25519 signatures over hashes.json.
  • Overview — the same decision, coverage, check, and compare rules in one page.
The repository README has the copy-paste demo, the fixture model table, and the container note. These pages go further for an operator. They do not replace that demo.