Skip to main content

grafomem serve

grafomem serve --port 8000 -e bge --auth token --db ./grafomem.db
FlagMeaning
--portlisten port
-e {stub,bge}embedder: deterministic stub or BGE embeddings (grafomem[backends])
--auth tokenenable Bearer-token auth (auth)
--db PATHSQLite path (:memory: for ephemeral)
--mcp {stdio,sse}expose the MCP tool surface (MCP)
--batchenable batched ingestion (ingestion)
--cloudenable Cloud Platform mode (requires PostgreSQL)

Cloud mode

When --cloud is set (or CLOUD_MODE=1), the server mounts the full inference governance layer:

grafomem serve --cloud --db postgresql://user:pass@host/grafomem --port 8000

This enables:

  • Decision Trail — inference audit log (/v1/decisions/)
  • Erasure Proof — GDPR certificates (/v1/erasure/)
  • Governance Gateway — policy engine (/v1/governance/)
  • Regulatory Reports — compliance packages (/v1/reports/)
  • Cloud Portal — web dashboard at /portal
  • Portal Auth — email/password signup + JWT sessions
  • Billing — Stripe integration for plan management
  • Metering — usage tracking per tenant

All Cloud services require PostgreSQL and are backed by psycopg v3.

note

Confirm the default port and full flag list against src/aml/server/app.py / grafomem serve --help for your version.