env.example

# Makefaster server configuration. Copy to .env — every value below is the
# default, so an empty .env boots against a local MariaDB.
#
#   cp env.example .env
#   docker compose up -d   # or a local mariadb on 127.0.0.1:3306
#   ./run.sh               # http://localhost:8787

# ---------------------------------------------------------------- listener

PORT=8787
HOST=0.0.0.0

# ----------------------------------------------------------------- database

# The schema must exist; migrations create the tables. parseTime=true is
# required so DATETIME columns decode into time.Time.
MARIADB_DSN=root:root@tcp(127.0.0.1:3306)/makefaster?parseTime=true

# goose migrations, applied on every server start. Relative to backend/.
MIGRATIONS_DIR=./internal/db/migrations

# Where the empty-database seed is read from: sites.json and improvements.json
# in this directory. Ignored once the tables hold rows. The committed data/ seed
# is empty — the public boards carry real submissions only — so a fresh database
# starts with empty leaderboards. To fill a local one, generate a synthetic pair
# (node scripts/generate-data.mjs --out-dir <dir>) and point this at it.
SEED_DIR=../data

# ----------------------------------------------------------------- frontend

# The SPA static root. Unknown app paths fall back to its index.html.
FRONTEND_DIR=../frontend

# --------------------------------------------------------- chains of thought

# Where POST /api/submit-trace stores the reasoning a run chose to hand over,
# as one 0600 JSON document per run in a 0700 directory. Deliberately outside
# the repo and outside FRONTEND_DIR: the one thing that must never happen to a
# trace is being served as a static file. No endpoint reads this back, nothing
# in it reaches a board or /data/*.json, and it is not where the CLI's imported
# checklist comes from.
#
# Set to "off" (or empty) to collect nothing: the endpoint then answers 503 and
# the CLI's question simply reports that this deployment does not collect them.
# The process needs write access to the parent directory.
# MAKEFASTER_TRACE_DIR=/var/lib/makefaster/traces

# --------------------------------------------------------------- embeddings

# Unset: the deterministic local feature-hashing embedder (no network, no key,
# match threshold 0.3). Set either key to use an OpenAI-compatible
# /v1/embeddings endpoint instead (threshold 0.55).
# MAKEFASTER_EMBEDDINGS_API_KEY=
# OPENAI_API_KEY=

# MAKEFASTER_EMBEDDINGS_MODEL=text-embedding-3-small
# MAKEFASTER_EMBEDDINGS_BASE_URL=https://api.openai.com/v1

# Cosine similarity at or above which a submitted improvement folds into an
# existing category instead of creating one. Overrides the per-backend default;
# only values strictly between 0 and 1 are honored.
# MAKEFASTER_MATCH_THRESHOLD=0.3

# ------------------------------------------------------------ hosted model

# The credential behind the CLI's `makefaster` provider: the server proxies
# OpenAI-compatible chat completions to OpenRouter under this key, so a user
# with no agent CLI and no key of their own can still run the loop. The CLI
# never sees it.
#
# Unset is a supported state: the provider still appears in the picker and
# POST /api/openrouter/v1/chat/completions answers 503 with an explanation.
#
# The models are allowlisted server-side — stealth/ox-alpha (the default) and
# z-ai/glm-5.2:free. The user picks between them in the CLI; anything else a
# client asks for is refused, so this cannot become an arbitrary-model proxy.
# The endpoint is rate limited per IP because it is subsidized.
# OPENROUTER_API_KEY=

# Point the proxy somewhere else (a mock, a gateway). Defaults to OpenRouter.
# MAKEFASTER_OPENROUTER_BASE_URL=https://openrouter.ai/api/v1

# ---------------------------------------------------------------------- test

# The MariaDB-backed Go tests skip unless this points at a throwaway schema.
# MAKEFASTER_TEST_MARIADB_DSN=root:root@tcp(127.0.0.1:3306)/makefaster_test?parseTime=true