install · v0.111.0

Un binaire. Ta machine.

Deux minutes jusqu'à ton premier run.

Nika, c'est un seul binaire Rust : pas de daemon, pas de compte, pas de cloud obligatoire. Choisis une porte d'entrée ci-dessous et lance ton premier fichier avec un modèle local gratuit.

macOS · Linux · air-gapped OK

1. 01 · homebrew

   La one-liner

   macOS ou Linux avec Homebrew : sur ton PATH immédiatement. Vérifie avec nika --version.

   ❯brew install supernovae-st/tap/…/nikaCopy

   ce que tu devrais voir

   ❯ nika --versionnika 0.111.0 (25f502adb)

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

2. 02 · script

   Sans Homebrew

   Télécharge le binaire de release vérifié dans ~/.nika/bin et imprime l'unique ligne PATH à ajouter à ton profil shell. Rouvre le terminal et nika --version répond.

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

   Une toolchain déjà en place ? cargo récupère le tarball de release précompilé, zéro compilation (le binaire arrive sous le nom nika-cli jusqu'à la publication crates.io : un symlink vers le nom public, une fois). nix construit la source exacte de la release via le flake du repo ; le premier run compile, le store met en cache.

   ❯cargo binstall --git https://github.com/supernovae-st/nika nika-cliCopy

   ❯nix run github:supernovae-st/nikaCopy

3. 03 · manuel

   Air-gapped, ou à la main

   Télécharge le tarball de ta plateforme et SHA256SUMS depuis la dernière release, vérifie, puis place nika sur ton PATH. Rien ne téléphone à la maison.

   ❯sha256sum -c SHA256SUMS --ignore-missingCopy

4. 04 · éditeur

   L'extension éditeur

   supernovae.nika-lang · sur le VS Code Marketplace et Open VSX (Cursor · Windsurf · VSCodium). Elle télécharge le binaire nika de la release correspondante au premier usage, ou réutilise celui déjà sur ton PATH. Tout autre éditeur : nika lsp parle LSP sur stdio · source + issues.

   complétions · diagnostics · une vue du plan · dans ton éditeur

5. 05 · agents

   Travaille avec tes agents

   Nika est conçu pour être écrit par des agents et relu par toi. nika init dépose le câblage du schema + AGENTS.md dans ton repo pour que Claude Code, Cursor, Codex et les autres écrivent des workflows valides du premier coup ; nika wire ajoute le câblage agent-tool (MCP) explicite là où tu le veux.

   ❯nika initCopy

   ❯nika wire cursorCopy

6. 06 · premier run

   Zéro clé, zéro cloud

   Commence par nika welcome, le miroir : ce que cette machine a déjà (éditeurs · modèles locaux · présence des clés, jamais leurs valeurs) et où aller ensuite. Ton premier workflow n'a besoin ni de modèle ni de clé API. Sauve le fichier, audite-le avec nika check (plan · coût · secrets, avant que rien ne tourne), puis nika run. Tu ajoutes une étape IA ? Pointe-la sur un modèle local gratuit (un ollama pull, rien ne quitte ta machine), et nika doctor te dit exactement ce qui est câblé.

   ❯nika welcomeCopy

   ❯nika check hello.nika.yamlCopy

   ❯nika run hello.nika.yamlCopy

   ❯ollama pull llama3.2:3bCopy

   ❯nika try 01-hello --model ollama/llama3.2:3bCopy

   ❯nika doctorCopy
   hello.nika.yamlsource ↗Copy

   1# first file after install · one exec, zero setup, zero keys2nika: hello3⛨permits:4  ⛨exec: ["echo"]5tasks:6  greet:7    ▷exec:8      command: ["echo", "hello", "from", "nika"]

   read it in the spec →

   ce que tu devrais voir

   ❯ 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 supervised❯ nika 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 ↗Copy

   1# first model call · one local seat, one bounded sentence2nika: hello-ai3model: ollama/llama3.2:3b   # local · zero key · swap for any provider in the catalog4⛨permits: {}5tasks:6  greet:7    ◇infer:8      prompt: "Say hello in one sentence."9      max_tokens: 6410​11outputs:12  greeting: ${{ tasks.greet.output }}

   read it in the spec →

Ensuite : apprends le fichier en 5 minutes · parcours des workflows réels · docs complètes