DeepBlue Dynamics / Docs / Nemesis8 / Installation

Installation

Get the Nemesis8 CLI running on your machine in under five minutes.

Requirements

Nemesis8 requires Docker Desktop (free). The CLI itself is a single binary.

Install

macOS / Linux

curl -fsSL https://nemesis8.nuts.services/install.sh | sh

Windows — PowerShell

powershell -c "irm https://nemesis8.nuts.services/install.ps1 | iex"

The installer places nemisis8 on your PATH and verifies Docker is available. Verify the install:

nemisis8 --version

On macOS, Gatekeeper may block the binary on first run. Right-click it in Finder and choose Open once, or run xattr -d com.apple.quarantine $(which nemisis8).

Manual download

If you prefer, grab a release archive directly from GitHub:

https://github.com/DeepBlueDynamics/nemesis8/releases

Initial configuration

Nemesis8 stores its configuration in ~/.nemesis8/config.toml. On first run this file is created automatically with defaults.

# View the generated config
nemisis8 doctor

SCREENSHOT — nemisis8 doctor output: config path, Docker running, providers listed

The key fields in ~/.nemesis8/config.toml:

[nemesis8]
version = "0.5"

[providers.claude]
api_key = "sk-ant-..."

[providers.codex]
api_key = "sk-..."

First run

Pull the base image and launch an interactive session:

# Pull the image (first build takes a few minutes)
nemisis8 build

# Start an interactive session with Claude
nemisis8 --provider claude interactive

SCREENSHOT — first interactive session in terminal

The first nemisis8 build compiles the entry binary inside Docker — this takes a few minutes. Subsequent starts are fast because the image is cached.