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
01 · homebrew
Der Einzeiler
macOS oder Linux mit Homebrew: sofort auf deinem
PATH. Prüf es mitnika --version.was du sehen solltestnika --versionnika 0.111.0 (25f502adb)
real output · nika 0.111.0 · nika --version · re-captured at every release
02 · script
Ohne Homebrew
Lädt das verifizierte Release-Binary nach
~/.nika/binund druckt die einePATH-Zeile für dein Shell-Profil. Terminal neu öffnen, undnika --versionantwortet.curl -LsSf https://nika.sh/install.sh | shToolchain 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-clinix run github:supernovae-st/nika03 · manuell
Air-gapped, oder von Hand
Lade den Plattform-Tarball und
SHA256SUMSvom letzten Release, verifiziere, dann schiebnikaauf deinenPATH. Nichts telefoniert nach Hause.sha256sum -c SHA256SUMS --ignore-missing04 · 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 passendenika-Release-Binary automatisch, oder nutzt das auf deinemPATHvorhandene. Jeder andere Editor:nika lspspricht 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 initlegt das Schema-Wiring +AGENTS.mdin dein Repo, damit Claude Code, Cursor, Codex und Co. beim ersten Versuch valide Workflows schreiben;nika wireergänzt explizites Agent-Tool-Wiring (MCP), wo du es willst.nika initnika wire cursor06 · 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 mitnika check(Plan · Kosten · Secrets, bevor irgendwas läuft), dannnika run. Ein KI-Schritt dazu? Zeig auf ein kostenloses lokales Modell (einollama pull, nichts verlässt deine Maschine), undnika doctorsagt dir exakt, was verkabelt ist.nika welcomenika check hello.nika.yamlnika run hello.nika.yamlollama pull llama3.2:3bnika try 01-hello --model ollama/llama3.2:3bnika doctorhello.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 solltestnika 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 ./nikahinter 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 | shchecksum 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-missingWeiter: lern das File in 5 Minuten · echte Workflows ansehen · volle Docs