{"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.111.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.111.0 (25f502adb)
```
real output · nika 0.111.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 try 01-hello --model ollama/llama3.2:3b

nika doctor

hello.nika.yamlsource

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

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

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: 641011outputs:12  greeting: ${{ tasks.greet.output }}

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