Configuration

Copy .env.example to .env. Everything has a default except the model key.

Core

Variable	Default	Meaning
DATABASE_URL	postgres://localhost:5432/crawler_agent	Postgres 17 with the vector extension
ANTHROPIC_API_KEY	–	Enables the analysis steps; without it, deterministic steps and the retrieval simulation still run
ANTHROPIC_WORKSPACE_ID	–	Required only when the key is org-scoped rather than workspace-scoped
RUN_MODE	inline	inline: the API process executes runs. worker: the API queues, npm run worker executes
WORKER_CONCURRENCY	2	Runs one worker process executes at once
SENTRY_DSN · SENTRY_ENVIRONMENT	–	Optional. Unhandled errors from the API and worker, tagged with organisation, workflow, step and request id
CRUX_API_KEY	–	Chrome UX Report API key (free, Google Cloud). Adds real-user Core Web Vitals to the performance profile; without it, lab data only
BRAND_NAME · BRAND_LOGO_URL · BRAND_ACCENT	Vercatus	Defaults when a workspace has no branding of its own

Models and cost

Variable	Default	Meaning
LLM_PROFILE	full	test = fast model, low effort, small caps; full = production
MODEL_EXTRACT · MODEL_ANALYZE · MODEL_CRITIC · MODEL_SYNTHESIZE	per profile	Override any tier
LLM_EFFORT	per call	Force one effort level everywhere
LLM_MAX_PAGES · LLM_MAX_INTENTS · LLM_SPECIALISTS · LLM_MAX_FINDINGS_PER_SPECIALIST	per profile	Caps
LLM_BATCH · LLM_BATCH_MIN_ITEMS	false · 20	Batches API for the bulk steps

Crawling

Variable	Default	Meaning
FETCH_CONCURRENCY	4	Pages in flight
FETCH_DELAY_MS	600	Minimum gap between requests to one host; doubles on 429
USER_AGENT	Vercatus/1.0 (+https://vercatus.com/crawler)	Sent on every request
WEB_BOT_AUTH_PRIVATE_KEY_PATH · WEB_BOT_AUTH_DIRECTORY	–	Sign requests (RFC 9421); the directory URL goes in Signature-Agent
EMBEDDING_MODEL	Xenova/multilingual-e5-small	Local embedding model for the retrieval index

Auth and tenancy

Variable	Default	Meaning
AUTH_MODE	single	single = no login, one workspace; multi = tenants, sessions, SSO
SESSION_SECRET · APP_URL	–	Sessions and redirect base
OIDC_ISSUER · OIDC_CLIENT_ID · OIDC_CLIENT_SECRET	–	Any OIDC provider
REQUIRE_DOMAIN_VERIFICATION	false	Require proof of ownership before crawling