Run it on your own data

Three steps: build the gateway, point it at your Postgres with your own LLM key, and query it in your own words.

  1. Build the image
    git clone https://github.com/SansWord/sans_schema.git
cd sans_schema
docker build -t sans-schema .
  2. Run it against your database

    The gateway introspects one flat (denormalized) view — point DB_VIEW at yours. Column comments improve resolution. Any LiteLLM model id works; set the matching provider key.

    docker run -p 8000:8000 \
  -e DATABASE_URL="postgresql://user:pass@host:5432/yourdb" \
  -e DB_VIEW="your_flat_view" \
  -e LLM_MODEL="gemini/gemini-3.1-flash-lite" \
  -e GEMINI_API_KEY="<your key>" \
  sans-schema
  3. Query it in your own words
    curl -s localhost:8000/query \
  -H 'Content-Type: application/json' \
  -d '{"want": ["any field, in your words"],
       "where": "a plain-language filter",
       "isVerbose": true}'

Full quickstart (local Postgres, seed data, every env var): gateway/README.md