AGPL-3.0-or-later · forever.

install · v0.105.0

バイナリひとつ。きみのマシンで。

最初の run まで 2 分。

Nika は Rust バイナリひとつ。daemon なし、アカウント不要、cloud も 必須ではない。下から入り口を選んで、無料のローカルモデルで最初の ファイルを動かそう。

macOS · Linux · air-gapped OK

  1. 01 · homebrew

    ワンライナー

    Homebrew のある macOS / Linux なら、すぐに PATH に載る。 nika --version で確認。

    表示されるはずのもの
    nika --versionnika 0.105.0

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

  2. 02 · script

    Homebrew なしで

    検証済みの release バイナリを ~/.nika/bin にダウンロードし、 シェルプロファイルに足す PATH の 1 行を表示する。ターミナルを 開き直せば nika --version が答える。

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

    toolchain がすでにあるなら: cargo はビルド済みの release tarball を 取ってくる。コンパイル不要（crates.io 公開までバイナリ名は nika-cli。 公開名への symlink を一度だけ張る）。nix はリポジトリの flake から release のソースをそのままビルドする。初回 run はコンパイル、store が キャッシュする。

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

  3. 03 · 手動

    air-gapped でも、手作業でも

    最新 release からプラットフォームの tarball と SHA256SUMS を ダウンロードして検証し、nika を PATH に置く。 どこにも通信しない。

    sha256sum -c SHA256SUMS --ignore-missing

  4. 04 · エディタ

    エディタ拡張

    supernovae.nika-lang · VS Code Marketplace と Open VSX にある （Cursor · Windsurf · VSCodium）。初回使用時に対応する nika release バイナリを自動ダウンロード、PATH 上の既存バイナリがあればそれを 使う。他のエディタなら: nika lsp が stdio で LSP を話す · source + issues。

  5. 05 · エージェント

    エージェントと一緒に

    Nika はエージェントが書き、きみがレビューするために作られている。 nika init が schema の配線と AGENTS.md をリポジトリに置き、 Claude Code · Cursor · Codex たちが一発で valid な workflow を書ける ようにする。nika wire は agent-tool（MCP）の明示的な配線を、 欲しい場所にだけ足す。

    nika init
    nika wire cursor

  6. 06 · 最初の run

    キーゼロ、cloud ゼロ

    まず nika welcome、鏡だ: このマシンに何があるか（エディタ · ローカルモデル · キーの有無だけ、値は決して見ない）と、次に 行く場所。最初の workflow にモデルも API キーも要らない。ファイルを 保存し、nika check で監査（plan · コスト · secrets を、何かが 動く前に）、それから nika run。AI ステップを足すなら 無料のローカルモデルへ（ollama pull ひとつ、マシンから何も 出ない）。nika doctor が配線済みのものを正確に教えてくれる。

    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
    nika: v1workflow:  id: hellotasks:  greet:    exec:      command: ["echo", "hello", "from", "nika"]
    表示されるはずのもの
    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 hintnika 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
    nika: v1workflow:  id: hello-aimodel: ollama/llama3.2:3b   # local · free · swap for any provider in the catalogtasks:  greet:    infer:      prompt: "Say hello in one sentence."

引っかかったら

command not found: nika（インストールスクリプトの後）

スクリプトは ~/.nika/bin にインストールし、シェルプロファイル （~/.zshrc, ~/.bashrc）に足す正確な PATH 行を表示する。 追加してターミナルを開き直せば nika --version が答える。

export PATH="$HOME/.nika/bin:$PATH"
macOS がバイナリをブロックする（手動 tarball のみ）

手でダウンロードしたバイナリは quarantine フラグ付き。brew と インストールスクリプトは付かない。一度クリアするか、右クリック → 開く。

xattr -d com.apple.quarantine ./nika
社内 proxy の内側で

インストールスクリプトは素の curl。ダウンロードには標準の proxy 変数をそのまま使う。バイナリ自体はどこにも通信しない。

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

mismatch は破損か改ざんされたダウンロードの印。実行しないこと。 release ページから tarball と SHA256SUMS を取り直して再検証する。

sha256sum -c SHA256SUMS --ignore-missing

次へ: 5 分でファイルを学ぶ · 実物の workflow を見る · フルドキュメント