Installation

Install NIKI on macOS, Linux, or build from source.

Install NIKI using your preferred method.

One-Line Install Script (Linux / macOS)

Downloads the official release binary and verifies its SHA-256 checksum:

curl -fsSL https://raw.githubusercontent.com/RavaniRoshan/niki/main/install.sh | bash

PowerShell Installer (Windows)

irm https://github.com/RavaniRoshan/niki/releases/download/v0.11.0/niki-installer.ps1 | iex

Pre-built Binaries (GitHub Releases)

Download pre-compiled static binaries directly from the Releases page:

# Linux (amd64)
curl -L https://github.com/RavaniRoshan/niki/releases/latest/download/niki_linux_amd64.tar.gz | tar -xz
sudo mv niki /usr/local/bin/

# macOS (Apple Silicon arm64)
curl -L https://github.com/RavaniRoshan/niki/releases/latest/download/niki_darwin_arm64.tar.gz | tar -xz
sudo mv niki /usr/local/bin/

# macOS (Intel amd64)
curl -L https://github.com/RavaniRoshan/niki/releases/latest/download/niki_darwin_amd64.tar.gz | tar -xz
sudo mv niki /usr/local/bin/

Homebrew (macOS / Linux)

brew install niki

Go Install

If you have Go 1.24+ installed:

go install github.com/RavaniRoshan/niki/cmd/niki@latest

Ensure your $GOPATH/bin or $HOME/go/bin is in your $PATH.

Build from Source

NIKI requires Go 1.24+.

git clone https://github.com/RavaniRoshan/niki.git
cd niki
go build -ldflags="-s -w" -o bin/niki cmd/niki/main.go
sudo cp bin/niki /usr/local/bin/

Verifying the Installation

Run niki doctor to inspect the installed version, local toolchain, config files, provider credential sources, container CLI, sandbox image, and security settings:

niki doctor

Illustrative output:

✓ niki version — 0.11.0
✓ go toolchain — go1.24.0
✓ container runtime — podman version 5.x
✓ git — git version 2.x
⚠ sandbox image present — niki-sandbox:24.04 not found locally