{"page":"/install","html_title":"Installation · Nika","fig":"install","title":"Ein Binary. Deine Maschine.","punch":"Zwei Minuten bis zum ersten Run.","lede":"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**.","stamp":"macOS · Linux · air-gapped OK","steps":{"brew":{"n":"01 · homebrew","title":"Der Einzeiler","plain":"macOS oder Linux mit Homebrew: sofort auf deinem `PATH`. Prüf es mit `nika --version`."},"script":{"n":"02 · script","title":"Ohne Homebrew","plain":"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.","plain2":"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."},"manual":{"n":"03 · manuell","title":"Air-gapped, oder von Hand","plain":"Lade den Plattform-Tarball und `SHA256SUMS` vom letzten Release, verifiziere, dann schieb `nika` auf deinen `PATH`. Nichts telefoniert nach Hause."},"editor":{"n":"04 · editor","title":"Die Editor-Extension","plain":"`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.","ghost":"Completions · Diagnostics · eine Sicht auf den Plan · in deinem Editor"},"agents":{"n":"05 · agents","title":"Arbeite mit deinen Agents","plain":"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."},"first_run":{"n":"06 · erster run","title":"Null Keys, null Cloud","plain":"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."}},"capture_title":"was du sehen solltest","trouble_title":"falls etwas hakt","trouble":[{"q":"command not found: nika (nach dem Install-Script)","a":"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."},{"q":"macOS blockiert das Binary (nur manueller Tarball)","a":"Ein von Hand geladenes Binary trägt das Quarantine-Flag; brew und das Install-Script nicht. Einmal entfernen, oder Rechtsklick → Öffnen."},{"q":"hinter einem Firmen-Proxy","a":"Das Install-Script ist pures curl; es respektiert die Standard-Proxy-Variablen für den Download. Das Binary selbst telefoniert nirgendwohin."},{"q":"checksum mismatch beim Tarball","a":"Ein Mismatch heißt: korrupter oder manipulierter Download. Nicht ausführen. Tarball und `SHA256SUMS` neu von der Release-Seite laden und erneut verifizieren."}],"more":{"next":"Weiter:","learn":"lern das File in 5 Minuten","usecases":"echte Workflows ansehen","docs":"volle Docs"},"labels":{"one_liner":"Install-Script","binstall":"cargo binstall","nix":"nix","checksum":"Checksum-Verifikation","repo_wiring":"Repo-Wiring","cursor_wiring":"Cursor-Agent-Wiring","welcome":"der Spiegel · starte hier","check":"statisches Audit","run":"run","ollama":"das kostenlose lokale Modell","example":"Beispiel-Run · lokales Modell","doctor":"Environment-Check"}}

install · v0.105.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

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.105.0
```
real output · nika 0.105.0 · nika --version · re-captured at every release
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
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
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.
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

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 examples run 01-hello --model ollama/llama3.2:3b

nika doctor

hello.nika.yaml

1nika: v12workflow:3  id: hello4tasks:5  greet:6    ▷exec:7      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 inference tasks · $0.00 ✔ SECRETS  no information-flow escapes ✔ TYPES    every deep output reference fits its declared shape ✔ TOOLS    every nika: tool names a canonical builtin ✔ ARGS     every invoke arg key is declared + every required arg is present ✔ SCHEMA   every authored schema: is satisfiable ○ PERMITS  no boundary declared (engine floor only) · `--infer-permits` writes one ↳ HINT     [permits] no `permits:` boundary declared — run `nika check --infer-permits` to generate the tightest one (default-deny once present) ✔ audited · 1 task · 1 wave · permits none · est ≥$0.0000 · 1 hint❯ nika run hello.nika.yaml  🦋 nika · hello · 1 task     permits ✓ engine floor (no boundary declared)  ✔  greet  exec · echo  4ms  ── 1/1 done · $0.00 · elapsed 0.0s ─────────────────────────────    trace: .nika/traces/2026-07-17T21-39-47Z-042f.ndjson · 5 events · chain e7a49a00ceacdc481547021c582c25066cc8f0ccdda4b54bedf71195dde8770d

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

hello-ai.nika.yaml

1nika: v12workflow:3  id: hello-ai4model: ollama/llama3.2:3b   # local · free · swap for any provider in the catalog5tasks:6  greet:7    ◇infer:8      prompt: "Say hello in one sentence."

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