The fastest start needs no clone at all: graphjin serve --demo with no
--path extracts the built-in saas-ops demo (SQLite, zero Docker)
to ./graphjin-demo and boots it in seconds.
graphjin serve --demoThe directories here are the full set of demos. From a repo clone, point
--demo at any of them with --path. Each is a self-contained vertical: one
command boots its databases (Docker containers and in-process emulators),
applies the schema DDL, seeds data, and starts the server:
graphjin serve --demo --path examples/<name>
# or: make demo DEMO_PATH=examples/<name>Put a model provider key (OPENAI_API_KEY, ANTHROPIC_API_KEY, or
GOOGLE_APIKEY) in ./.env and --demo switches to the authenticated
agentic config. The dev and agentic configs both get the server-side agent,
MCP, watches, and managed artifacts from their mode defaults.
| Demo | Domain | Sources | Port | First boot |
|---|---|---|---|---|
| coffee-roastery | Specialty coffee ops | Postgres + BigQuery-emu + TypeScript CodeSQL + workflows | 8080 | ~1-2 min (postgres pull) |
saas-ops — built-in (graphjin serve --demo) |
SaaS company ops | SQLite (zero Docker) + workflows | 8083 | seconds |
| corrugated-plant | Corrugated-box manufacturing | MySQL + BigQuery-emu + Python CodeSQL + JWT roles + workflows | 8081 | ~2-4 min (mysql pull) |
| pcb-fab | PCB design + fab | Postgres + Snowflake-emu + MongoDB + file source + OpenAPI supplier API + TypeScript CodeSQL | 8082 | ~3-5 min (postgres+mongo pull) |
| webshop | Minimal single-DB starter | Postgres | 8080 | ~1 min |
Every demo ships an end-to-end smoke suite that exercises data queries, saved queries, workflows, watches (create/fire/inbox), the artifact store (including projection caps and locked kinds), structured agent refusals, role-gated control-plane access, and automatic server-first model routing with MCP client fallback:
examples/<name>/scripts/smoke.sh # base checks
examples/<name>/scripts/smoke.sh --agent-eval # + agent protocol evals (needs a model key)The coffee-roastery demo also includes a lexical-versus-semantic catalog comparison. It starts both configurations, uses deterministic embeddings by default, and asserts synonym recall, real relationship paths, exact-match precedence, unrelated-query gating, and zero document embeddings on warm startup:
examples/coffee-roastery/scripts/semantic-smoke.sh
examples/coffee-roastery/scripts/semantic-smoke.sh --agent # deterministic REST agent + Ax/Goja coverage batch
examples/coffee-roastery/scripts/semantic-smoke.sh --live # real provider key requiredRun everything in sequence with a summary table (Docker + ./.env required):
make smoke-all
# scripts/demo-smoke-all.sh --only <name> for a single demoThe suites share one harness, lib/smoke-common.sh:
transport/assert helpers, dev-header and JWT auth modes, legacy stateful-MCP
session helpers, and generic capability suites each demo composes with its own
domain checks. Model-resolution checks verify that missing GraphJin-owned
provider credentials fail closed with model_credentials_required.
