AGPL-3.0-or-later · forever.

install · v0.111.0

Ein Binary. Deine Maschine.

Zwei Minuten bis zum ersten Run.

Nika ist ein einziges Rust-Binary: kein Daemon, kein Account, keine Cloud nötig. Wähl unten einen Weg hinein und starte dein erstes File mit einem kostenlosen lokalen Modell.

macOS · Linux · air-gapped OK

  1. 01 · homebrew

    Der Einzeiler

    macOS oder Linux mit Homebrew: sofort auf deinem PATH. Prüf es mit nika --version.

    was du sehen solltest
    nika --versionnika 0.111.0 (25f502adb)

    real output · nika 0.111.0 · nika --version · re-captured at every release

  2. 02 · script

    Ohne Homebrew

    Lädt das verifizierte Release-Binary nach ~/.nika/bin und druckt die eine PATH-Zeile für dein Shell-Profil. Terminal neu öffnen, und nika --version antwortet.

    curl -LsSf https://nika.sh/install.sh | sh

    Toolchain schon an Bord? cargo holt den vorgebauten Release-Tarball, kein Kompilieren (das Binary landet als nika-cli, bis der crates.io-Publish steht: einmal einen Symlink auf den öffentlichen Namen legen). nix baut die exakte Release-Source über das Repo-Flake; der erste Run kompiliert, der Store cacht.

    cargo binstall --git https://github.com/supernovae-st/nika nika-cli
    nix run github:supernovae-st/nika
  3. 03 · manuell

    Air-gapped, oder von Hand

    Lade den Plattform-Tarball und SHA256SUMS vom letzten Release, verifiziere, dann schieb nika auf deinen PATH. Nichts telefoniert nach Hause.

    sha256sum -c SHA256SUMS --ignore-missing
  4. 04 · editor

    Die Editor-Extension

    supernovae.nika-lang · im VS Code Marketplace und auf Open VSX (Cursor · Windsurf · VSCodium). Sie lädt beim ersten Einsatz das passende nika-Release-Binary automatisch, oder nutzt das auf deinem PATH vorhandene. Jeder andere Editor: nika lsp spricht LSP über stdio · Source + Issues.

  5. 05 · agents

    Arbeite mit deinen Agents

    Nika ist gebaut, um von Agents geschrieben und von dir reviewt zu werden. nika init legt das Schema-Wiring + AGENTS.md in dein Repo, damit Claude Code, Cursor, Codex und Co. beim ersten Versuch valide Workflows schreiben; nika wire ergänzt explizites Agent-Tool-Wiring (MCP), wo du es willst.

    nika init
    nika wire cursor
  6. 06 · erster run

    Null Keys, null Cloud

    Starte mit nika welcome, dem Spiegel: was diese Maschine schon hat (Editoren · lokale Modelle · Key-Präsenz, nie Werte) und wohin als Nächstes. Dein erster Workflow braucht weder Modell noch API-Key. Speichere das File, auditiere es mit nika check (Plan · Kosten · Secrets, bevor irgendwas läuft), dann nika run. Ein KI-Schritt dazu? Zeig auf ein kostenloses lokales Modell (ein ollama pull, nichts verlässt deine Maschine), und nika doctor sagt dir exakt, was verkabelt ist.

    nika welcome
    nika check hello.nika.yaml
    nika run hello.nika.yaml
    ollama pull llama3.2:3b
    nika try 01-hello --model ollama/llama3.2:3b
    nika doctor
    hello.nika.yamlsource
    # first file after install · one exec, zero setup, zero keysnika: hellopermits:  exec: ["echo"]tasks:  greet:    exec:      command: ["echo", "hello", "from", "nika"]
    was du sehen solltest
    nika check hello.nika.yamlnika check · hello.nika.yaml  PLAN     1 wave · 1 task · max parallelism 1      wave 1 greet (exec · echo)  COST     no infer/agent tasks · $0.00 · exec + mcp spend unpriced  SECRETS  no declared secret reaches an effect · model echo untracked  TYPES    deep references fit the shapes tasks declare · builtin output has none  TOOLS    every named nika: tool is canonical · globs + mcp: not checked  ARGS     every builtin invoke arg key is declared + required args present  SCHEMA   no known-unsatisfiable form in an authored schema: · $ref opaque  GATES    no task proven dead · status literals in vocabulary  WRITES   no two unordered tasks write the same static path · computed paths at run  EXEC     no literal argv the exec floor refuses at run · a templated argv is the RUN's verdict  PERMITS  literal + const: args fit the boundary · computed paths + symlinks are the RUN's verdict · exec outside the fs bounds  TRIFECTA no lethal trifecta over the declared permits: without a human gate  JOURNEY internal · 0 sources · 1 destination · 0 model endpoints · no secret reaches a cloud destination  audited · 1 task · 1 wave · permits declared · est out ≤$0.0000 · 0 hints · risk supervisednika run hello.nika.yaml  🦋 nika · hello · 1 task     permits ✓ declared boundary · exec outside the fs bounds    greet  exec · echo  9ms  ── 1/1 done · $0.00 · elapsed 0.0s ─────────────────────────────    trace: .nika/traces/2026-08-18T23-26-42Z-0a8e.ndjson · 7 events · chain a145a48cf0d995069384cbd8332a067c01d7490f78190897cd6bdf46f40b90b6

    real output · nika 0.111.0 · nika check hello.nika.yaml · re-captured at every release

    hello-ai.nika.yamlsource
    # first model call · one local seat, one bounded sentencenika: hello-aimodel: ollama/llama3.2:3b   # local · zero key · swap for any provider in the catalogpermits: {}tasks:  greet:    infer:      prompt: "Say hello in one sentence."      max_tokens: 64outputs:  greeting: ${{ tasks.greet.output }}

falls etwas hakt

command not found: nika (nach dem Install-Script)

Das Script installiert nach ~/.nika/bin und druckt die exakte PATH-Zeile für dein Shell-Profil (~/.zshrc, ~/.bashrc). Zeile einfügen, Terminal neu öffnen, und nika --version antwortet.

export PATH="$HOME/.nika/bin:$PATH"
macOS blockiert das Binary (nur manueller Tarball)

Ein von Hand geladenes Binary trägt das Quarantine-Flag; brew und das Install-Script nicht. Einmal entfernen, oder Rechtsklick → Öffnen.

xattr -d com.apple.quarantine ./nika
hinter einem Firmen-Proxy

Das Install-Script ist pures curl; es respektiert die Standard-Proxy-Variablen für den Download. Das Binary selbst telefoniert nirgendwohin.

HTTPS_PROXY=http://proxy:8080 curl -LsSf https://nika.sh/install.sh | sh
checksum mismatch beim Tarball

Ein Mismatch heißt: korrupter oder manipulierter Download. Nicht ausführen. Tarball und SHA256SUMS neu von der Release-Seite laden und erneut verifizieren.

sha256sum -c SHA256SUMS --ignore-missing

Weiter: lern das File in 5 Minuten · echte Workflows ansehen · volle Docs