Skip to content

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.

  1. 01

    Standalone CLI

    Homebrew or the install script downloads the released engine. Check nika --version after 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 --version
    Verify 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.3
    Full CLI install on docs.nika.sh
  2. 02

    First run, no key

    In an empty directory, compile writes a first workflow file and run executes it with mock/echo standing 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 0
    What 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.

  3. 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.3 bundles engine 0.124.3. Mint the run-signing key once with NIKA_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 run node 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.3

    Expected rehearsal stdout: mock(echo) · Say hello from the Nika SDK. then receipt verified

    The SDK page and its filesSDK quickstart on docs.nika.sh

  4. 04

    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 lsp and the JSON Schema.