Skip to main content
Nika never asks you to configure blind. Two commands read your machine offline, by presence only, and hand you the next step: nika welcome is the short mirror, nika doctor the full diagnosis with a fix line for each gap.

The mirror

Captured from nika 0.124.0, installed where the install script puts it, in an empty folder ~/demo on a machine with no keys, no configuration and no editor wired.
Read it from the top:
  • The recommendation. The first lines name one way to a real answer for this machine. Nika Gear One is an open-weights local model sized to your memory that nika model pull downloads and that needs no API key: here a 7.4 GB Gemma 3 12B file for an 18 GB machine. Local inference is unpriced, not free: it runs on your hardware. Other rows appear when Nika detects a signed-in agent app or a provider key. A key’s row reads OPENAI_API_KEY is set · not checked until the first call: nothing here calls the provider, so a revoked key only shows on that first call. See Local models for the sizes, and the one limit of serving them.
  • Next: is the line to type now: writes a starter file offline, without any key or model call.
  • this machine names each gap and the command that closes it, never a vendor to buy from.
  • this binary opens with the binary that is running: its version and commit, the installer it came from and its path. When another nika on your PATH differs from it, a second line says so and sends you to nika doctor. The counts below it are derived from the embedded language pack, never typed by hand. Its providers are the ones this build can drive: local servers and cloud APIs, without mock. The specification names providers, counting mock, the rehearsal provider that makes no model call. nika catalog lists entries and marks the ones this build cannot drive as catalog only; nika check refuses those.
  • The five-line workflow is real: an engine test pins that it checks clean. It appears only while your workspace has no workflow.
nika welcome --json emits the same mirror for programs (welcome_version: 1), and --ascii swaps every glyph for plain characters. Nika has no hosted service and none is planned: every path the mirror names runs on your machine or with a provider key you choose.

The diagnosis

Three rules shape the report:
  • Presence, never values. A key is reported set or unset; its value is never read into a variable, so it cannot reach your terminal, a log or a trace.
  • Offline by default. The base report touches nothing on the network. --ping (opt-in) probes the local servers you can configure: a connect to each loopback port, then a bounded GET of its model list. It runs no inference, downloads nothing and never contacts a vendor endpoint.
  • Diagnose only. Doctor prints fixes and never runs them. nika wire and nika key init are the explicit commands that change something.

A fresh machine, honestly

Captured from nika 0.124.0 without a terminal, on a fresh HOME that holds only the binary, with no agent app installed: the whole report, with the binary’s path shortened to ~/.nika/bin/nika.
Warnings are not failures: with no workflow in hand, doctor cannot know which provider, agent app or editor you need, so it lists every path you could take. nika doctor --verbose unfolds the advisory line with a fix for each note.

Probe the local servers

The local row says the providers need a running server; --ping checks whether one is there. Each probe connects to the default loopback port (300 ms cap), then asks the server for its model list with one bounded GET of /v1/models. Here Ollama is running with no model pulled:
An open port is not taken for an engine on its own: a server that answers a web page instead of an API reads accepts connections … but answers a page, not an API … — not a model server, a 401 or 403 reads key-protected, and a 404 reads no /v1/models route (the nika model serve sidecar has none). One reachable server with a model is a fully local inference path: no key, no cloud, no account. Local models sets one up.

For scripts and agents

Every fact above ships as JSON; agents and CI branch on summary.fail instead of parsing glyphs:

The fixes that change something

Doctor never edits a configuration. When a row says fix: nika wire cursor, that command, and only that command, writes the MCP wiring, idempotently, keeping whatever other servers the file already lists:

Next

First workflow

Your first run needs none of the keys above: mock/echo needs no key and makes no model call.

Local models

Turn the local or sidecar row into a working, keyless inference path.

Editors

Schema validation and the nika lsp language server.

Agents

nika init briefs your agents; nika wire gives them the oracle.