Nika v0.124.3 · open source · macOS and Linux
Install Nika.
Run workflows on your own machine. The standalone program supports macOS and Linux. No Nika account is required; AI steps use the model credentials you configure.
01
Standalone CLI
Homebrew or the install script downloads the released engine. Check
nika --versionafter installation and read the release notes.❯brew install supernovae-st/tap/nika❯curl -LsSf https://nika.sh/install.sh | sh❯docker run --rm ghcr.io/supernovae-st/nika:0.124.3 --versionFull CLI install on docs.nika.shVerify the download: three independent proofs
verifybash # 1 · checksum: the bytes you hold are the bytes CI hashed sha256sum -c SHA256SUMS --ignore-missing # macOS: shasum -a 256 -c # 2 · attestation: GitHub-signed build provenance for this exact artifact gh attestation verify nika-<platform>-0.124.3.tar.gz --repo supernovae-st/nika # 3 · SLSA provenance: the intoto asset, verifiable offline slsa-verifier verify-artifact nika-<platform>-0.124.3.tar.gz \ --provenance-path multiple.intoto.jsonl \ --source-uri github.com/supernovae-st/nika --source-tag v0.124.302
First run, no key
In an empty directory, compile writes a first workflow file and run executes it with
mock/echostanding in for a model: no account, no key, no download. The run checks its permits first and leaves a hash-chained trace in.nika/traces.❯nika compile hello hello.nika❯nika run hello.nika --max-cost-usd 0What nika v0.124.3 printed to stdout · recorded ❯ nika compile hello hello.nika Compile ready · source-only Check preview; Run checks its environment again. wrote hello.nika next · nika run hello.nika ❯ nika run hello.nika --max-cost-usd 0 🦋 nika · hello · 1 task permits ✓ declared boundary · default-deny ✔ greet infer · mock/echo 0ms 1 task · 1 wave · 0 retries · 10 tok ── 1/1 done · unpriced (1 call) · elapsed 0.0s ───────────────── wrote .nika/traces verify it: nika trace verify said "mock(echo) · Say hello in French, in one sh…" see it whole: nika trace outputs rehearsal · a mock model echoed the prompt — not a real answer explore: nika run hello.nika --json > run.ndjson · nika trace outputs run.ndjson trace: .nika/traces/<this run> · 5 events · chain <hash-chained>
Standard output only. Timings read 0ms and 0.0s, and the trace name and chain hash are placeholders: they change on every run.
03
Optional TypeScript SDK
Prerequisite: Node.js 22 or newer, on macOS or Linux (glibc), arm64 or x64. The published package
@supernovae-st/nika@0.124.3bundles engine 0.124.3. Mint the run-signing key once withNIKA_KEYCHAIN=off ./node_modules/.bin/nika key init, which writes it as the files the engine your app starts reads, save the two files from the SDK page, then runnode demo.mts. Node.js 22.18 or newer runs demo.mts as is; on an older 22.x, name it demo.mjs and remove <{ greeting: string }>.❯npm install @supernovae-st/nika@0.124.3Expected rehearsal stdout:
mock(echo) · Say hello from the Nika SDK.thenreceipt verified04
Advanced
Platforms, servers, and model configuration live in the docs. The editor extension, frozen at 0.120 and not qualified with 0.124: use
nika lspand the JSON Schema.