ddsyasas/llm-wiki

First minor release since the v1.x line began — adds first-class local-model support via Ollama plus the UX scaffolding that makes it self-explanatory to use.

Headline contribution by @savindugeethma — first external PR merged into the project. 4-round review process (PR #1 → PR #2) before landing as squash commit 35149a3. Thanks for the patient iteration.

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.0/syasas-llm-wiki-1.2.0.tgz.

What's new

Local models (Ollama) as a first-class provider

Run any operation (ingest / query / chat / lint / vision) against a model on your own machine instead of OpenRouter. Free per query after the one-time model download. Fully private — your sources never leave your laptop.

• Settings → Models: each slot now has a Provider dropdown — choose OpenRouter (cloud) or Ollama (Local). Mix and match per slot.
• 10 suggested Ollama models in the dropdown (llama3, mistral, phi3, llava, etc.) with sensible vision-only filtering on the vision slot.
• Backward compatible: existing wiki configs with the old string model shape are auto-migrated to the new { provider, model } shape on next read. No manual edits needed.
• If you only use Ollama: no OpenRouter API key required. The first-run wizard skips the key step entirely when at least one operation is set to Ollama.

Settings banner — heads-up when Ollama is selected

Amber banner appears at the top of Settings → Models if any slot uses Ollama, listing which slots and linking to the setup guide. Removes the "I selected Ollama, why am I getting Connection error?" failure mode that bit users who selected Ollama without realizing Ollama itself has to be installed locally first.

/local-models setup guide

New in-app page with everything needed to actually use Ollama:

• Install commands for macOS / Linux / Windows
• How to pull a model + verify Ollama is running
• Hardware requirements table covering 9 common models (phi3 / llama3 / mistral / mixtral / llama3:70b / gemma2 / llava / moondream / phi3:medium) with disk size, RAM minimum + recommended, tokens-per-sec on Apple Silicon vs CPU-only, and what each model is best for
• "Quick picker" mapping 5 common hardware profiles ("old 8 GB laptop" / "modern 16 GB" / "Apple Silicon 64 GB unified" / etc.) to recommended models
• Custom OLLAMA_BASE_URL env var for tunneled or networked Ollama
• Troubleshooting for the 6 errors users actually hit

Cross-linked from /help (new section + TOC entry) and /developers (Swapping LLM providers section).

Other fixes

• All v1.1.x improvements still in (cross-platform install, npm publish, case-insensitive CLI commands, welcome banner, etc.)
• Test suite up to 195 passing (1 new test for the legacy-string-shape WikiSettings migration)

Upgrading from v1.1.x

Wiki on-disk format is unchanged within v1.x. The settings shape change is handled transparently by the parser. Just install the new version:

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

Then optionally open Settings → Models to try the new Provider dropdown.

Platform notes

• macOS: verified
• Linux (incl. WSL): verified
• Windows: verified

Same as v1.1.0/v1.1.1 — better-sqlite3 and keytar install per-platform via npm.

Full changelog

See dev-log.md sections P through V for the full sequence from V1.x sprint through this release.