{"page":"/install","html_title":"Instalação · Nika","fig":"install","title":"Um binário. Sua máquina.","punch":"Dois minutos até o seu primeiro run.","lede":"Nika é **um único binário Rust**: sem daemon, sem conta, sem cloud obrigatória. Escolha uma porta de entrada abaixo e rode seu primeiro arquivo com um **modelo local gratuito**.","stamp":"macOS · Linux · air-gapped OK","steps":{"brew":{"n":"01 · homebrew","title":"O one-liner","plain":"macOS ou Linux com Homebrew: no seu `PATH` na hora. Confira com `nika --version`."},"script":{"n":"02 · script","title":"Sem Homebrew","plain":"Baixa o **binário de release verificado** em `~/.nika/bin` e imprime a única linha `PATH` para adicionar ao seu perfil de shell. Reabra o terminal e `nika --version` responde.","plain2":"Já carrega uma toolchain? O **cargo** busca o tarball de release pré-compilado, sem compilar (o binário chega como `nika-cli` até a publicação no crates.io: um symlink para o nome público, uma vez). O **nix** constrói a source exata da release via o flake do repo; o primeiro run compila, o store guarda em cache."},"manual":{"n":"03 · manual","title":"Air-gapped, ou na mão","plain":"Baixe o tarball da sua plataforma e o `SHA256SUMS` da última release, verifique, e mova o `nika` para o seu `PATH`. Nada liga para casa."},"editor":{"n":"04 · editor","title":"A extensão do editor","plain":"`supernovae.nika-lang` · no VS Code Marketplace e no Open VSX (Cursor · Windsurf · VSCodium). Ela baixa automaticamente o binário `nika` da release correspondente no primeiro uso, ou reutiliza o que já está no seu `PATH`. Qualquer outro editor: `nika lsp` fala LSP por stdio · source + issues.","ghost":"completions · diagnósticos · uma visão do plano · no seu editor"},"agents":{"n":"05 · agentes","title":"Trabalhe com os seus agentes","plain":"Nika foi feito para ser **escrito por agentes e revisado por você**. `nika init` coloca o wiring do schema + `AGENTS.md` no seu repo para que Claude Code, Cursor, Codex e companhia escrevam workflows válidos de primeira; `nika wire` adiciona wiring agent-tool (MCP) explícito onde você quiser."},"first_run":{"n":"06 · primeiro run","title":"Zero chaves, zero cloud","plain":"Comece com `nika welcome`, o espelho: o que esta máquina já tem (editores · modelos locais · *presença* de chaves, nunca valores) e para onde ir depois. Seu primeiro workflow não precisa de modelo nem de chave de API. Salve o arquivo, audite com `nika check` (plano · custo · secrets, antes de qualquer coisa rodar), depois `nika run`. Vai adicionar um passo de IA? Aponte para um **modelo local gratuito** (um `ollama pull`, nada sai da sua máquina), e o `nika doctor` diz exatamente o que está ligado."}},"capture_title":"o que você deve ver","trouble_title":"se algo travar","trouble":[{"q":"command not found: nika (depois do script de instalação)","a":"O script instala em `~/.nika/bin` e imprime a linha `PATH` exata para adicionar ao seu perfil de shell (`~/.zshrc`, `~/.bashrc`). Adicione, reabra o terminal, e `nika --version` responde."},{"q":"macOS bloqueia o binário (só tarball manual)","a":"Um binário baixado na mão carrega a flag de quarantine; brew e o script de instalação, não. Remova uma vez, ou clique direito → Abrir."},{"q":"atrás de um proxy corporativo","a":"O script de instalação é curl puro; ele respeita as variáveis proxy padrão para o download. O binário em si não liga para lugar nenhum."},{"q":"checksum mismatch no tarball","a":"Um mismatch significa download corrompido ou adulterado. Não execute. Baixe de novo o tarball e o `SHA256SUMS` da página da release e verifique outra vez."}],"more":{"next":"Próximo:","learn":"aprenda o arquivo em 5 minutos","usecases":"veja workflows reais","docs":"docs completas"},"labels":{"one_liner":"script de instalação","binstall":"cargo binstall","nix":"nix","checksum":"verificação de checksum","repo_wiring":"wiring do repo","cursor_wiring":"wiring do agente Cursor","welcome":"o espelho · comece aqui","check":"auditoria estática","run":"run","ollama":"o modelo local gratuito","example":"run de exemplo · modelo local","doctor":"check do ambiente"}}

install · v0.105.0

Um binário. Sua máquina.

Dois minutos até o seu primeiro run.

Nika é um único binário Rust: sem daemon, sem conta, sem cloud obrigatória. Escolha uma porta de entrada abaixo e rode seu primeiro arquivo com um modelo local gratuito.

macOS · Linux · air-gapped OK

01 · homebrew
O one-liner
macOS ou Linux com Homebrew: no seu PATH na hora. Confira com nika --version.
o que você deve ver
```
❯ nika --versionnika 0.105.0
```
real output · nika 0.105.0 · nika --version · re-captured at every release
02 · script
Sem Homebrew
Baixa o binário de release verificado em ~/.nika/bin e imprime a única linha PATH para adicionar ao seu perfil de shell. Reabra o terminal e nika --version responde.
curl -LsSf https://nika.sh/install.sh | sh
Já carrega uma toolchain? O cargo busca o tarball de release pré-compilado, sem compilar (o binário chega como nika-cli até a publicação no crates.io: um symlink para o nome público, uma vez). O nix constrói a source exata da release via o flake do repo; o primeiro run compila, o store guarda em cache.
cargo binstall --git https://github.com/supernovae-st/nika nika-cli
nix run github:supernovae-st/nika
03 · manual
Air-gapped, ou na mão
Baixe o tarball da sua plataforma e o SHA256SUMS da última release, verifique, e mova o nika para o seu PATH. Nada liga para casa.
sha256sum -c SHA256SUMS --ignore-missing
04 · editor
A extensão do editor
supernovae.nika-lang · no VS Code Marketplace e no Open VSX (Cursor · Windsurf · VSCodium). Ela baixa automaticamente o binário nika da release correspondente no primeiro uso, ou reutiliza o que já está no seu PATH. Qualquer outro editor: nika lsp fala LSP por stdio · source + issues.
05 · agentes
Trabalhe com os seus agentes
Nika foi feito para ser escrito por agentes e revisado por você. nika init coloca o wiring do schema + AGENTS.md no seu repo para que Claude Code, Cursor, Codex e companhia escrevam workflows válidos de primeira; nika wire adiciona wiring agent-tool (MCP) explícito onde você quiser.
nika init
nika wire cursor

06 · primeiro run

Zero chaves, zero cloud

Comece com nika welcome, o espelho: o que esta máquina já tem (editores · modelos locais · presença de chaves, nunca valores) e para onde ir depois. Seu primeiro workflow não precisa de modelo nem de chave de API. Salve o arquivo, audite com nika check (plano · custo · secrets, antes de qualquer coisa rodar), depois nika run. Vai adicionar um passo de IA? Aponte para um modelo local gratuito (um ollama pull, nada sai da sua máquina), e o nika doctor diz exatamente o que está ligado.

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"]

o que você deve ver

❯ 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."

se algo travar

command not found: nika (depois do script de instalação)

O script instala em ~/.nika/bin e imprime a linha PATH exata para adicionar ao seu perfil de shell (~/.zshrc, ~/.bashrc). Adicione, reabra o terminal, e nika --version responde.

export PATH="$HOME/.nika/bin:$PATH"

macOS bloqueia o binário (só tarball manual)

Um binário baixado na mão carrega a flag de quarantine; brew e o script de instalação, não. Remova uma vez, ou clique direito → Abrir.

xattr -d com.apple.quarantine ./nika

atrás de um proxy corporativo

O script de instalação é curl puro; ele respeita as variáveis proxy padrão para o download. O binário em si não liga para lugar nenhum.

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

checksum mismatch no tarball

Um mismatch significa download corrompido ou adulterado. Não execute. Baixe de novo o tarball e o SHA256SUMS da página da release e verifique outra vez.

sha256sum -c SHA256SUMS --ignore-missing

Próximo: aprenda o arquivo em 5 minutos · veja workflows reais · docs completas