Installation

Kairos Substrate is distributed as a native package for Linux and macOS. The installer places only the kairos binary on your system PATH — no configuration files, services, or databases are created.

Native Package Install

Linux (.deb)

Download kairos-substrate_<version>_amd64.deb from the release artifacts, then install:

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

Verify:

kairos --help

Uninstall

sudo dpkg -r kairos-substrate

macOS (.pkg)

Download kairos-substrate-<version>-arm64.pkg from the release artifacts.

Caution

The macOS package is not currently signed with a Developer ID certificate. macOS Gatekeeper will block the installer by default. To proceed:

1. Right-click (or Control-click) the .pkg file in Finder.
2. Select Open from the context menu.
3. Click Open in the dialog to confirm.

Alternatively, remove the quarantine attribute from the terminal:

xattr -d com.apple.quarantine kairos-substrate-<version>-arm64.pkg

Then double-click to install normally.

The package installs the binary to /usr/local/bin/kairos.

Verify:

kairos --help

Uninstall

macOS packages do not include a native uninstall mechanism. Remove the binary manually:

sudo rm /usr/local/bin/kairos

To also remove the package receipt (optional):

sudo pkgutil --forget dev.anankelabs.kairos-substrate

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>_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
request.example.json	Example evaluation request
artifact.example.json	Example artifact placeholder
policy.example.json	Example policy placeholder

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

Next Steps

After installing, you need to activate a license before running evaluations.