MAYA /mä-yä/

The Offline Twin. Build the graph on your machine before it ever touches the cloud.

Why a Local Twin?

Cloud-only graphs make iteration painful — every test costs Gemini tokens, every schema change risks production. MAYA gives you a complete, byte-identical SUMA brain that runs entirely on your laptop.

Same Postgres schema. Same K-WIL gravity. Same Pāṇinian semantic roles. Same 7-Layer Cognitive Stack. Just no network round-trips, no billing, no fear of breaking prod.

Two-Mode Boot

LOCAL MODE — DEFAULT

$ bash scripts/dev-run.sh

  SUMA Pro — LOCAL MODE (MAYA, no Google OAuth)
  DB:           localhost:5432/sumapro_dev
  Bearer token: sk_dev_gg_local
  Org:          MAYA (org_id=2)
  Google OAuth: BYPASSED
  Envelope:     DISABLED (plaintext for easy curl)

One command. Local Postgres, dev bearer token, Google OAuth bypassed, AES-256-GCM envelope disabled — perfect for curl, Postman, DBeaver, and the YUVA extension running locally.

PRODUCTION MODE

$ LOCAL_MODE=false bash scripts/dev-run.sh

Same script, production-grade auth: Google OAuth on, Cloud SQL connection, envelope encryption restored. Identical code path — only the env flips.

Local PostgreSQL + pgvector

All 42 SUMA tables, all catalog data, real 768-dim embeddings — running on your laptop in <30s.

Ghost Gate Bypass

A fixed dev API key (sk_dev_gg_local) that maps to the MAYA org — no Google OAuth dance during dev.

Browser-Friendly

Visit /dev-signin once → every web page works locally as if you signed in with Google.

DBeaver-Ready

Connect any SQL client to postgres@localhost:5432/sumapro_dev and watch nodes form in real-time as you ingest.

The Doctrine

MAYA is not a separate codebase — it's the same Flask app, the same Postgres schema, the same K-WIL retrieval. Only the auth layer and the database endpoint differ. Code that works in MAYA is the same code that ships to production.

In Sanskrit, माया (māyā) means the appearance that hides the deeper structure. Here, the offline appearance hides the production-identical deep structure.

Back to the Engine