nika welcome is the
short mirror, nika doctor the full diagnosis with a fix line for each gap.
The mirror
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.
- 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 pulldownloads 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 readsOPENAI_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 machinenames each gap and the command that closes it, never a vendor to buy from.this binaryopens with the binary that is running: its version and commit, the installer it came from and its path. When anothernikaon yourPATHdiffers from it, a second line says so and sends you tonika 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, withoutmock. The specification names providers, countingmock, the rehearsal provider that makes no model call.nika cataloglists entries and marks the ones this build cannot drive as catalog only;nika checkrefuses 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
- 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 boundedGETof 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 wireandnika key initare the explicit commands that change something.
A fresh machine, honestly
Captured fromnika 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.
nika doctor --verbose unfolds the advisory line with a fix for each
note.
Probe the local servers
Thelocal 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:
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 onsummary.fail instead
of parsing glyphs:
The fixes that change something
Doctor never edits a configuration. When a row saysfix: 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.