Skip to content

Keiko 0.3.13 (v0.3.13)

Choose a tag to compare

View all tags
@oscharko oscharko released this 20 Aug 17:20
· 188 commits to dev since this release
Immutable release. Only release title and notes can be modified.
v0.3.13
This tag was signed with the committer’s verified signature.
oscharko Oliver Scharkowski
SSH Key Fingerprint: Q/v63726rkhP1BH+PmTv6gncTPHWgmtwmbLStBw1hKQ
Verified
Learn about vigilant mode.
7d28e7b
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

Keiko 0.3.13

Keiko's first public download release. Pick your platform below, unzip, and start it —
Node.js and the OpenCode sidecar are already inside; nothing else has to be installed.

Unsigned evaluation build (ADR-0121 D1, ADR-0163 D9). The bundles are sealed, so macOS
will not report a damaged app, but they carry no Apple Developer ID, no notarization and no
Windows trusted publisher yet. That is why the first launch needs the one extra confirmation
described below. Every integrity digest, containment and provenance check stays enforced.

What changed

Keiko 0.3.13 Release Notes

High · Fixes

  • A model's role now comes from the gateway's own declaration (LiteLLM /model/info mode) rather than from its name. A declared reranking, speech, image-generation or moderation engine can no longer be stored as an embedding model because its id happens to contain a token like "bge" or "e5"; the name heuristic applies only where a gateway declares nothing.
  • Models Keiko will not configure are now reported with the declared reason in the setup dialog instead of vanishing without a trace, and they no longer consume slots in the discovery limit — a gateway listing many speech or reranking endpoints can no longer push real chat models out of the configured set.
  • Every declared embedding model is verified with one real embedding request during setup. A model that cannot answer is not stored as an embedding model; a model whose role you asserted explicitly, or that was already stored, is kept and flagged as unverified so a brief endpoint outage cannot unpin working Knowledge Pods.
  • Gateways whose /model/info route is unavailable, restricted or rate-limited continue to set up exactly as before by falling back to the plain model list; only a response in which every model declares a mode Keiko cannot use is surfaced as an error.
Technical release metadata
  • Package: @oscharko-dev/keiko@0.3.13
  • Release tag: v0.3.13
  • npm dist-tag: latest
  • Registry: https://registry.npmjs.org/
  • Generated by: npm run release:publish

Structured impact entries:

  • 2026-08-20-keiko-0.3.13-model-agnostic-role-recognition: high / fixes; supported from 0.2.0; affected state stores none; remediation restart-required; default patch notes yes; traceability catalog:2026-08-20-keiko-0.3.13-model-agnostic-role-recognition; review:github-issue-comment:#3204#5358465374

Install on macOS

  1. Download and unzip; double-click Keiko.app inside the extracted folder (moving it to
    /Applications first also works — the first start adopts it there).
  2. macOS will say it cannot verify the developer. Open System Settings → Privacy &
    Security    , scroll to Security, click Open Anyway, and confirm. One time only.
  3. Keiko installs itself to /Applications, starts, and opens at http://127.0.0.1:1983.

If a start fails, Keiko now says why in a dialog. Runbook:
macOS first-launch

Install on Windows

Run keiko-windows-x64-setup.exe (SmartScreen: More info → Run anyway), or unzip and start
Keiko.exe.

Checksums (SHA-256)

80819d7f4079a4e86c516374d0695924302fecf5516ef8106077e6e2d05aed91  keiko-macos-arm64.zip
deb95d568d18d0791fe4c3d3a410abdd64a9bc321fcfd643d3c0ee59abfbb90a  keiko-macos-x64.zip
a0bec4ddf870d2ab0ca38b7e6bc008981bca2a2d170499892b645f28ba4fa3d2  keiko-windows-x64.zip
d53b4c3dd1bd9684e97b81d593fe8daa82ff7c5a0088578f24ac7b7d7118a0c1  keiko-windows-x64-setup.exe

macOS seal verification: verified (keiko-macos-arm64.zip, keiko-macos-x64.zip).
Built from commit 7d28e7b by workflow run 32393257950.

Assets 8
Loading