Installation

Kairos Substrate is distributed as a native package for Debian Linux on x86-64. The installer places only the kairos binary on your system PATH. It creates no configuration files, services, or databases.

Native Package Install

Linux (.deb)

Download kairos-substrate_<version>-1_amd64.deb from the release artifacts. Then install the package:

sudo dpkg -i kairos-substrate_<version>-1_amd64.deb

To verify the installation, run:

kairos --help

Uninstall

sudo dpkg -r kairos-substrate

macOS (.pkg)

As of v1.0.0, the release artifacts contain no macOS package. The Linux package is the only native install.

Verify Download Integrity

Each release includes a SHA256SUMS file listing all release artifacts. To verify a specific download, extract its line from the manifest:

grep kairos-substrate_<version>-1_amd64.deb SHA256SUMS | sha256sum -c -

Starter Kit

The starter kit is a separate versioned archive containing reference configuration files and quick-start documentation. It is not required for CLI usage.

Download kairos-substrate-starter-kit-<version>.tar.gz from the release artifacts:

tar xzf kairos-substrate-starter-kit-<version>.tar.gz

Contents:

File	Purpose
README.md	Quick-start guide
coordinator.example.toml	Reference HITL coordinator configuration. A template: edit all paths before use.
deployment-policy.reference.json	Reference deployment policy that shows the schema. It is not valid for evaluation.

These files are illustrative. Use the signed deployment files provided for your licensed environment when running real evaluations.

Next Steps

Before you run evaluations, activate a license.