Playground

Speak to a live engine.

Every statement below runs against the public read endpoint of gigi-stream.fly.dev — the same production instance the GIGI Builds exercise consoles use. No key, no signup, no sandbox: the response you see is what the engine said.

checking /v1/health…
POST /v1/public/gql
Console

Type GQL. Get geometry back.

gql statement endpoint
or Ctrl/Cmd + Enter
one click fills the editor — Run sends it. What's loaded on the public instance changes over time; an empty bundle answers with empty rows and zero counts, honestly.
response nothing sent yet
— run a statement to see what the engine says —
The read surface

What you can run here — and what you can't.

The public endpoint is an allowlist of read verbs. Statements outside it come back 403 — the engine answers "verb not allowed on the public read endpoint" rather than pretending. The console above turns that into a plain note.

Verb
What comes back
SHOW BUNDLES;
The bundle names this endpoint exposes.
HEALTH <bundle>;
Record count, curvature, confidence, storage mode — one bundle's vitals.
DESCRIBE <bundle>;
Schema summary: base and fiber field counts, storage mode. DESCRIBE <bundle> VERBOSE lists the fields.
SECTION <bundle> AT key=value;
One record's fiber — the read form only. The write form (SECTION b (…)) is a 403 here.
EXISTS SECTION <bundle> AT key=value;
A boolean: is there a section at that base point.
COVER <bundle> ON … WHERE …;
A set of sections. ON hits the index bitmap; WHERE filters by scan; combined, bitmap first then filter.
INTEGRATE <bundle> [OVER f] MEASURE …;
Aggregates — the fiber integral over a base partition.
SELECT … FROM <bundle> …;
The SQL-compatibility spelling of a read.
CURVATURE <bundle> ON field;
The field's curvature K — global, per-group with BY, or scoped with WITHIN.
SPECTRAL <bundle> [FULL [LIMIT k]];
Spectral gap λ₁ of the index graph; FULL returns the eigenvalue spectrum, LIMIT k the k smallest.
403 by design

Writes — SECTION … UPSERT, CREATE BUNDLE, deletes, admin verbs — need an API key on a private deployment. Run your own engine from GitHub or Docker Hub, start it with GIGI_CORS_ORIGIN=* for browser access (dev only), point the endpoint field above at it — the full verb list is in the docs.