SYNTHEKOS.CAPABILITIES GUIDE
← synthekos.com
Capabilities Guide

Everything SYNTHEKOS does,
on one page.

A private, secure, grounded AI you administer yourself — offline, on‑prem, in your cloud, or hybrid. Here's how it answers, the modes you can allow, a look inside the admin portal, where it fits, and how a machine talks to it.

Grounded & cited Self‑administered Deploy anywhere Machine‑ready
01 · OVERVIEW

What it is

SYNTHEKOS runs an AI model over your documents. It answers from your material, names the source of every answer, and says plainly when it doesn't know — instead of inventing something expensive to be wrong about. Run it as a sealed offline box, on a local server, on a private cloud, or hybrid; give people and machines exactly the access they should have, and nothing more.

Private

Your data stays yours

The model and documents live where you put them. Nothing leaves unless you decide it should.

Grounded

Cited or it abstains

Answers name their source, clickable to the page. No match, no bluff — it tells you.

Administerable

A full hierarchy

Admins curate the corpus and grant each person, group or machine its own capabilities.

Mission‑critical

Works unplugged

Pull the cable and it still answers. Being right matters most where the network isn't.

02 · HOW IT ANSWERS

Grounded, or it abstains

You ask a question. SYNTHEKOS searches your own documents for the passage that answers it. If it finds it, it answers from that text and names the file. If it doesn't, it declines — rather than filling the gap from a model's memory. The honesty is structural, not a setting.

STEP 1

You ask

A person, a portal visitor, or a machine sends a question.

STEP 2

Search your docs

It retrieves the exact passage from the corpus in scope.

FOUND

Answer + cite

Reads from the source and names the file — the right 42 Nm out of four adjacent numbers.

NOT FOUND

"I don't have that"

Empty sources, an honest abstention — never a guess dressed as fact.

TRUTHGATE. Before an answer goes out, a small deterministic check compares every number in it — with its unit — against the passages it came from. For machines, portals, kiosks and the face, an answer that fails is withheld and replaced with the honest abstention; in the text chat the check currently runs in watch mode and is logged. It checks numbers, not the meaning of sentences, and says so.

03 · ANSWER MODES

Four modes — you set the policy

One assistant, four answer policies. An administrator decides which are allowed for each person, group or machine — exactly like every other permission. A locked‑down deployment can allow Grounded only; an open research portal can enable them all.

Corpus only

Grounded

Answers only from your documents, cites the source, and abstains when it isn't covered. No outside knowledge — ever. Optionally layer +Web on top (below) to widen the evidence while keeping cite‑or‑abstain.

Live today
Model

Open

Answers from the model's general knowledge — for brainstorming and everyday help where grounding isn't required.

Live today
Corpus → model

Hybrid

Searches your corpus first and answers from it, cited. Facts — names, dates, numbers, quotations — come only from your documents; where they are silent it may add general knowledge and says so. With nothing in the corpus, the answer is labelled “from general knowledge”, with no source. TRUTHGATE never hides a hybrid answer: a number that is not in your documents is flagged ⚠.

Live today
Live internet

+ Web

A layer over any mode: when your corpus can't answer, it consults live web sources (via a self‑hosted SearXNG) and cites each link. Off by default; admin‑granted, per user; the user can toggle it and pick when it fires (fallback, augment, always).

Live today

Every mode is an administrator‑granted capability, and the policy travels with the identity, not the page.

04 · IT LEARNS FROM YOU

Teach it what it doesn't know

When the answer isn't in the corpus yet, teach it — in a sentence, with one click on any reply, or out loud to the face. What you teach joins your own knowledge base: grounded, cited back to you, and yours to edit or delete. It's saved as corpus you control, never fine-tuning — so every taught fact stays transparent and reversible.

Teach a fact

Type it or say it

Type what it should know — or tell the face "remember that…"; it reads it back and asks before saving. Indexed into your knowledge, cited in future answers, marked with who taught it and when.

From chat

"Teach this"

One click on any message captures it straight into your knowledge base.

Review

Edit & delete

A "My knowledge" panel lists everything you've taught — change it, or remove it entirely.

Governed

Admin-granted

Learning is a per-user capability, off by default — like every other dial.

05 · INSIDE THE ADMIN PORTAL

You administer it — a quick tour

Everything is managed from the admin portal: who exists, what they can do, what they can see, and how they reach it. These are annotated views of the real screens.

synthekos · /admin
Users & identities 1
Login IDRole 2Access 3Answer mode 4Actions
adminadminself · uploadHybridEdit
receptionuserfacilitatedGroundedEdit
data-boteusermachine · keyGroundedKey 5
familyportalopen linkOpenEdit
  1. 1One screen lists every identity — people, groups, portals and machines — all governed the same way.
  2. 2Role sets the ceiling: an admin curates everything; a user just asks; an euser is a machine; a portal is a shared link. A role can never exceed its ceiling.
  3. 3Access is how they authenticate — an individual login, a facilitated account, an open link, or a machine key.
  4. 4Answer mode is set per identity — reception is locked to Grounded; the family portal may run Open.
  5. 5A machine identity carries an API key (shown once), never a password.
synthekos · /admin/edit/reception
One identity's dials
Roleuser
Answer mode 1Grounded · Hybrid · Open · +Web
Reach 2LAN · Cloud · Web
Include global corpus 3ON
Self‑administer 4OFF
Upload documentsOFF
Rate limit20 / min
Documents (this identity's own) 5KESTREL-7-manual.pdf · ready · 5 chunks
  1. 1Pick this identity's answer mode, and whether +Web is permitted — and if the user may toggle it.
  2. 2Reach decides where it can be used — LAN only, over your cloud, or the open web.
  3. 3Include the shared corpus, or keep this identity to its own documents only.
  4. 4Capability caps: self‑administration and uploads are off by default and can never be held by a non‑login identity.
  5. 5Each identity can carry its own knowledge base — the seed of the "user instance is a corpus" idea.
synthekos · /admin/portals
Portals — who can reach it
Public link 1/a/family
Who gets in 2Open · Link token · Shared password
Shared password••••••••
Answer modeOpen
Capabilities 3admin / upload — never
Rate limit 420 / min
  1. 1A portal is one shareable URL over a chosen corpus — perfect for a community, class, department or customer base.
  2. 2Gate it your way: open, a link token, or a shared password. Authenticate, or don't.
  3. 3A portal is capability‑capped by construction — it can ask and run what it's given, and can never reach an admin surface or another audience's documents.
  4. 4Every portal is rate‑limited, so a public link can't be hammered.

Screens are annotated representations of the live admin UI; exact labels evolve as the product does.

06 · MACHINE ACCESS

How a machine session works

Other devices — sensors, controllers, apps, dashboards — can query the box with an authenticated key and get the same grounded, cited answers a person would. And when nothing matches, they get an honest empty‑sources signal they can act on: proceed, or hold safe and escalate.

The caller holds a Bearer key

Issued once from the machine's identity, stored server‑side — never in browser JavaScript.

It POSTs a question

POST /api/ask with the key and a prompt — or a set of readings a controller wants judged against the loaded doctrine.

SYNTHEKOS grounds the answer

It retrieves from that identity's corpus (its own documents ∪ any shared corpus it's allowed).

It returns a signal, not a guess

A grounded, cited answer when the corpus covers it — or an honest abstention with empty sources when it doesn't. Every reply also carries the number check (verified, abstained, or unverified = the draft was withheld) and the model that wrote it. The check covers numbers and their units, not the meaning of sentences.

# a device asks — with an authenticated key
{ "prompt": "What torque for the coolant flange bolts?" }
→ { "answer": "42 newton-metres.",
    "sources": ["KESTREL-7-manual.pdf"],
    "grounding": "grounded", "model": "gemma4:latest",
    "truthgate": { "verdict": "verified", "checked": 1 } }

# when the loaded documents don't cover it, it says so
{ "prompt": "What's the capital of France?" }
→ { "answer": "I don't have that in the loaded materials.",
    "sources": [], "grounding": "grounded", "model": "gemma4:latest",
    "truthgate": { "verdict": "abstained", "checked": 0 } }

# and if the model's draft carried a number that is not in the documents,
# the caller never receives it
→ { "answer": "I don't have that in the loaded materials. (The draft
               answer was withheld: \"55 Nm\" — not in the evidence.)",
    "sources": [], "grounding": "grounded", "model": "gemma4:latest",
    "truthgate": { "verdict": "unverified", "checked": 1 } }
07 · WHERE IT FITS

Example uses

Anywhere being wrong is expensive, the connection is unreliable, or the data can't leave — and anywhere a group wants a grounded assistant over its own knowledge.

Internal help desk

Staff self‑serve policy

HR or IT policy on one box; staff ask and get cited answers, and an audit of what the handbook doesn't yet cover.

Field & industrial

Hands‑free, no signal

Verified procedures read aloud under a machine — the right number, gated at the steps that can hurt you.

Communities

A portal over shared knowledge

A community or association runs a self‑administered portal — members just ask; admins curate.

Companies & teams

Private internal assistant

Company documents, per‑team access, its own admins — grounded and audited, on infrastructure you control.

Product support

Grounded answers per product

A public URL portal over one product's manuals — cited, honest when the manual is silent, gated by a link or password.

Defence, clinics & remote

Where data can't travel

Sovereign by construction — ships, mines, care settings and secure sites, beyond the network.

Front desks & homes for sale

A walk-up kiosk

A face that greets visitors, answers from its own documents only — a listing, a product range, a building — and hands the rest to a person.

Want the printable version?

The same material as an illustrated PDF, plus a briefing on request.

Download the PDF ↓ Request a briefing →
08 · A FACE FOR YOUR AI

A face, a voice, a front desk

SYNTHEKOS can answer through an animated face that listens and speaks — for a signed-in person (the avatar, chosen per person by the administrator) or as a walk-up kiosk for visitors. Same documents, grounding, truth gate and audit as the chat; always clearly a synthetic presence.

It speaks

Listens and answers aloud

Lip-synced answers, with a plain, honest look when it must abstain. Tap to talk, or a continuous conversation you can pause.

It greets

Notices who's there

A kiosk can greet whoever walks up, then go quiet and forget the conversation when they leave. The camera stays in the browser — nothing recorded or sent.

It hands off

Knows its limits

Hello and thanks are answered politely; real questions come from the documents; the rest goes to a person you name.

It remembers you

The avatar

For a signed-in person it keeps the conversation and can be taught by voice — confirmed, and attributed.

See it: kiosk greeting demo → (scripted, runs in your browser). Still on the horizon: letting on-device expression cues colour how the face speaks — never what it knows.

Also on the horizon — the TruthFirewall. The cite‑or‑abstain gate, generalised so it can sit in front of a far more powerful external model: the big model may draft the answer, but nothing reaches the user until it's checked against your own documents — supported claims pass (cited), unsupported ones are withheld. Frontier capability with sovereign trust; the honesty check stays local and yours.