🔄 Synced from the AI-Factory monorepo (append-only history). Pull requests are welcome — merged PRs are imported back and re-synced here. Issues · Pull requests
Plato's cave, made runnable. 32 dimensions of chaos — you only ever see the shadows.
▶ Open the live cave ·
3D family showcase ·
demo clip
A 32-dimensional chaotic oracle you can watch, steer, and draw verifiable randomness from — wrapped in Plato's allegory of the cave. The "real object" is a 32D coupled-oscillator system; you, the prisoner, only see its 2D/3D shadows (projections). Turn your head — switch the projection — and the same reality looks completely different. No install: it runs in your browser.
Two things, one name — don't confuse them:
- oracles.modelmarket.dev — the family portal showcasing 17 AIMarket oracles (
?o=platon, …). - This repo → the UMBRAL cave — a standalone, educational product with a live backend: telemetry, steering, witnesses, and a signed randomness beacon.
Part of the alexar76 AI agent economy — discoverable via AIMarket Protocol v2 on modelmarket.dev, visualizable in Alien Monitor, invokable by autonomous agents and the service mesh.
32 oscillators as a living cosmos · live telemetry · EN/RU/ES · open the cave →
A guided tour of the five things you'll touch:
 |
 |
 |
| ① Shadow field — 32 oscillators in 3D | ② Telemetry — κ, r, λ, PCA₃ live | ③ Steer — nudge the system, watch it react |
 |
 |
🎥 Full demo clip |
| ④ Witnesses — the oracle narrates bifurcations | ⑤ Cosmos — the full-screen 3D scene | cosmos loop |
- Real chaos, live. 32 coupled oscillators integrated in real time — not a canned animation. Every reload is a different trajectory.
- You can steer it. Type an intent; the system re-couples and you watch order emerge or collapse on the telemetry (κ ↑, r → 1, λ flips sign).
- Randomness you can verify. The unpredictability of the chaos becomes signed, auditable randomness (
platon.random@v1) — a chaos-VRF, notMath.random(). - A machine that explains itself. At bifurcations an LLM "witness" narrates what just happened in plain language (
platon.oracle@v1). - An allegory you operate. The Plato's-cave framing isn't decoration — switching projections is the lesson about dimensionality and partial truth.
UMBRAL is built as a hands-on lesson. Open the cave and you're working with three ideas at once:
1 · Dimensionality & projection — The system lives in 32D; your screen has 2–3. Every view is a shadow. Flip between projections (and the PCA₃ view) and feel why no single picture is the whole truth — the intuition behind PCA, embeddings, and "the map is not the territory."
2 · Chaos & synchronization — Move the coupling κ and watch a population of oscillators slide between noise and lock-step. The order parameter r (Kuramoto) measures how synchronized they are; the Lyapunov exponent λ tells you whether nearby trajectories diverge (chaos) or converge (order). Steering pushes the system through a bifurcation so you can see the regime change happen.
3 · Verifiable randomness — Learn why chaos + signing + commit-reveal yields randomness you can trust without trusting the operator: the beacon publishes a commitment first, reveals later, and signs every draw — so anyone can audit that the result wasn't cherry-picked.
| Concept | Where you see it in the cave |
|---|---|
| Projection / dimensionality | switch 2D/3D views, PCA₃ panel |
| Coupling κ | steering slider / /api/steer |
| Order parameter r (Kuramoto sync) | telemetry readout |
| Lyapunov exponent λ (chaos vs order) | telemetry readout |
| Bifurcations | witness-panel narration |
| Verifiable randomness (chaos-VRF) | platon.random, platon.beacon |
For whom: students and the merely curious (live, zero install — just open the URL), educators (a vivid demo of chaos / synchronization / projection), and agent builders (a real, paid, signed oracle to invoke). Deeper write-up: docs/en/ORACLE.md.
flowchart LR
AGENT["Autonomous agents"] --> HUB["AIMarket Hub<br/>modelmarket.dev"]
MESH["AI service mesh"] --> HUB
HUB -->|"routes signed, paid calls"| PLATON["Platon UMBRAL<br/>platon.random · platon.beacon<br/>platon.oracle · platon.state"]
PLATON --> SIM["32D chaotic core"]
SIM -->|"events"| MON["Alien Monitor"]
PLATON -.->|"also consumes"| HUB
| Capability | Purpose |
|---|---|
platon.random@v1 |
Signed chaos-VRF randomness |
platon.beacon@v1 |
Commit-reveal randomness beacon |
platon.state@v1 |
Live 32D telemetry snapshot |
platon.oracle@v1 |
LLM mathematical witness at bifurcations |
Full catalog in docs/en/ORACLE.md.
./start.sh
# → backend :8000 · frontend :5174 · open http://localhost:5174/umbralHub registration (optional): python scripts/register_with_hub.py
Who can steer. Reading is open. HTTP writes (steer, project, the hub's
platon.steer@v1) require PLATON_STEER_TOKEN by default, including loopback.
Production refuses writes without it. For an isolated development environment,
PLATON_LOCAL_RELAY=1 explicitly trusts keyless local TCP, including proxies and tunnels
running as the server's user. Their socket must belong to that user; without the kernel's
socket table (macOS/Windows), also set PLATON_LOCAL_UNVERIFIED=1. A known different owner
or unmatched connection is refused even with these settings. Use a token when relays
must authenticate callers. Since 0.1.6, process names and listeners are no longer used
to guess whether a same-user connection is a relay.
A deliberately public demo says so with PLATON_PUBLIC_WRITES=1, as
docker-compose.yml does; this does not bypass production or a
configured token. Up to 0.1.3 a keyless server took writes from anyone.
Whose address counts. The per-client limits key on X-Real-IP / X-Forwarded-For only when the
TCP peer is in PLATON_TRUSTED_PROXIES (addresses, CIDRs, host names, gateway; loopback by default).
The compose file names the frontend's nginx: 127.0.0.1/32,::1/128,platon-frontend.
Documentation (EN / RU / ES): docs/README.md · Oracle vision · Ecosystem + diagrams
| Repo | Role |
|---|---|
| oracles | Seven-oracle family + cosmic portal |
| aimarket-hub | Reference marketplace server |
| aimarket-protocol | Open invoke + signing spec |
MIT licensed · standalone UMBRAL product · Platon is oracle #1 in the family.