KKOS Web SDK — build a model in the browser
One HTML file, one script tag, no build step and no dependencies. It opens a text session, sends your turns, then calls /mirror/complete to build an 11-dimension model and renders every dimension with its score, confidence and evidence.
/mirror/start, /mirror/message,
/mirror/complete) are login-gated and need a user token (Bearer). A platform API key
covers /health, /plans and /mirror/voices, but not sessions.
Paste whichever you have below — it is kept in this browser's localStorage only.
Your turns
Model
Run a session to see the 11 dimensions here.
What this page demonstrates
1. Zero-dependency transport. kkos.js is a single UMD file that works as a
plain <script> or an ES module. It wraps fetch and turns every non-2xx
response into a typed KKOSError carrying status, payload and URL.
2. The envelope, unwrapped. /mirror/complete returns
{session_id, model_id, redirect, model}. Call kk.completeModel() to get
model directly, or kk.traits(resp) to normalise the trait list out of either shape.
3. Confidence is part of the answer, not a footnote. Every dimension carries its own confidence and the evidence string it was derived from. When the conversation is too short the engine returns an explicit insufficient data reading at 0.4 instead of inventing a score — you can see that behaviour for yourself by running a session with a single turn.
Measurement of how often that fallback fires, and how repeatable the scores are, is published in Effect Reports 01 and 02.
Source
kkos.js — browser / ES module client · kkos_client.py — Python, standard library only · example.py — Python runnable example
Serve this page from the same origin as the API, or enable CORS on the API host — the SDK uses plain fetch.