ddsyasas/llm-wiki

Patch release. Lowers the cost-to-first-ingest from "spend a few cents per source" to "$0", with a first-run wizard step that helps new users find the option without hunting through Settings.

Install

npm install -g @syasas/llm-wiki@latest
# or pin: npm install -g @syasas/[email protected]

If npm is unavailable: npm install -g https://github.com/ddsyasas/llm-wiki/releases/download/v1.2.3/syasas-llm-wiki-1.2.3.tgz.

What's new

Free OpenRouter models in the dropdown. Settings → Models now lists four curated :free routes alongside the paid options:

• meta-llama/llama-3.3-70b-instruct:free — proven JSON, 131K ctx. Best for ingest and lint.
• nvidia/nemotron-3-super-120b-a12b:free — 1M ctx. Best for query and chat.
• deepseek/deepseek-v4-flash:free — fast reasoning, 1M ctx. Alternative for query/chat.
• google/gemma-4-31b-it:free — vision-capable, 262K ctx. The only credible free vision pick.

All four are tagged with FREE in the dropdown notes. Pricing is set to $0/M tokens, so cost previews and the usage tracker show real numbers.

Settings → Models banner. When any slot uses a :free route, an amber banner surfaces the three things users need to know:

1. Rate limits — ~20 req/min, ~50/day on a fresh account; ~1000/day after $10 of OpenRouter credit is added (deposit raises the cap even for free routes).
2. Data retention — some free routes pass through providers that retain prompts for training. Paid Anthropic/OpenAI routes don't.
3. JSON reliability — if you hit a "schema validation failed" error, switch the offending slot to a paid model.

Same amber palette as the existing Ollama banner since both are "you made a non-default choice with caveats".

First-run wizard nudge. Step 2 of 3 ("OpenRouter API key") gained a small block under the keychain note: "Prefer zero per-call cost? Use free OpenRouter models." One toggle button sets sensible free-tier defaults across all five operation slots. Users still enter their key (OpenRouter accounts are free; what changes is the per-call cost, not whether you need to sign up). Two-click setup for a fully working zero-cost wiki.

Why not just point at the existing Ollama path?

Ollama is the truly key-less path and works great, but it needs local compute (10–30 GB RAM for the larger models). Free OpenRouter fills a different gap: cloud-quality models with zero per-call cost for users whose laptops can't run a 70B locally. The two paths coexist — pick whichever matches your machine.

Upgrading

npm install -g @syasas/llm-wiki@latest

Existing settings (whichever paid model you chose) are preserved. To switch to free models post-upgrade: Settings → Models → pick a (free) entry per slot, Save.

Patch-fix bundled in this release: stale assertion in the vision-ingest test that was missed during the v1.2.1 PDF fix. Tests are green again on a clean checkout.