Documentation

SuperChargeDB

An object-storage-native, multimodal vector + document search engine built on a modern serverless cloud platform. It returns the exact moment, region, passage, or line — not just a document id — behind a single enforcement core that clamps scope, intersects grants, and ACL-filters every result.

What it is#

SuperChargeDB indexes your content as Units — the atom of retrieval (a doc chunk, an image region, a video shot, an audio utterance, a log template). Each Unit carries a Locator so results point at the precise sub-unit span. A query fans out across retrieval planes (text, visual, audio, doc-visual), fuses the ranked lists with Reciprocal Rank Fusion, reranks with a cross-encoder, and returns hits with a full cost/latency trace.

How it works#

Ingest — content is embedded with managed inference and written to the SQL catalog (filterable/BM25 row) plus the vector index (vector + pushdown metadata).
Retrieve — a query is embedded, searched against the vector index per plane, and against a catalog FTS5 lexical index, all scope-clamped.
Fuse & rerank — ranked lists are combined with RRF, then a cross-encoder reranks the survivors.
Enforce — every candidate passes a per-hit ACL filter before it is ever returned; denied hits are counted, never leaked.

Try it now#

The API is live and seeded with a demo dataset. Use the test token aegis_sk_alice to run your first search:

curl

curl -s -X POST "https://superchargedb.krisch1218.workers.dev/v1/search" \
  -H "Authorization: Bearer aegis_sk_alice" \
  -H "Content-Type: application/json" \
  -d '{"q":"Q3 revenue miss and gross margin","top_k":5}'

Base URL & test principals

The documented REST base URL is https://superchargedb.krisch1218.workers.dev. Two seeded principals demonstrate access control: aegis_sk_alice (admin, all scopes, in the finance group) and aegis_sk_bob (read-only, backend scope only). See Authentication.

Documentation map#

QuickstartRun your first authenticated hybrid search in under a minute.AuthenticationBearer tokens, session cookies, scope headers, and the test principals.Core conceptsUnits, Locators, planes, modalities, scopes, and namespaces.Data model & ingestionHow a Unit is split across the SQL catalog and the vector index, and how to ingest text.Query & the AegisQuery ASTThe validated query object: filters, operators, consistency, and budget.Multimodal hybrid searchImage/audio/video/doc retrieval across four planes, RRF fusion, reranking, Locators, and the trace.Cited answersGrounded synthesis via POST /v1/answer: retrieve → localize → verify → cite, with an NLI faithfulness score.Security modelRBAC/ABAC, scope clamping, grant intersection, ACL filtering, hash-chained audit.REST APIEvery endpoint: method, path, headers, params, request/response, and errors.SDK, CLI & MCPTypeScript + Python SDKs, the CLI, and the MCP server — install and quickstart snippets.Audit & verificationRead the hash-chained audit log and independently verify the chain is intact.Console guideA tour of the web console: search playground, unit browser, and overview.ArchitectureThe cloud-native deployment and request lifecycle.RoadmapWhat is live today and what is coming next.

Prefer a UI?

The console gives you a live playground for hybrid search, planes, and the trace panel — the same enforcement core the API uses.

Launch the console