INSTALL / STABLE RELEASE

Install Ouroboros.

Use a packaged desktop build for the shortest setup. Each download contains the managed runtime and an optional user-local CLI installer.

macOS

macOS 12 or newer on Apple silicon.

Open latest release

Download the Ouroboros-<version>.dmg, drag Ouroboros to Applications, then run Install CLI.command if you want the CLI.

Linux

x86_64 Linux.

Open latest release

Download the Linux tarball, extract it, and run ./Ouroboros/Ouroboros. The CLI installer is in ./Ouroboros/bin/.

Windows

64-bit Windows.

Open latest release

Download the Windows ZIP, extract it, and run Ouroboros.exe. The CLI installer is in Ouroboros\bin\.

Run from source

Source mode needs Python 3.10 or newer and Git.

git clone https://github.com/razzant/ouroboros.git
cd ouroboros
python3.11 -m venv .venv
source .venv/bin/activate
python -m pip install --upgrade pip setuptools wheel
python -m pip install -r requirements.txt
python -m pip install -e . --no-deps
ouroboros server

Verify the download

Proof files vary by release. Check the selected release for its checksums and evidence file, if present. Releases built by the current workflow also include CycloneDX SBOMs, packaged smoke receipts, and GitHub attestations. install.json gives machine-readable release discovery, artifact name templates, and accepted proof filenames.