Configuration

Meridian reads src/config.json. Copy from src/config.example.json on first install. You can edit via the Settings panel (Profile · Search & run · LLM) or directly in the file.

See also: Dashboard guide.

Config sections

Section Purpose
profile Name, skills, titles, resume summary
preferences Search queries, score threshold, easy apply toggles
locationPolicy Expected physical location for hybrid / WFO roles
salary Compensation filters and research inputs
transition Career transition mode inputs
portals Enable or disable LinkedIn and Naukri
llm Provider, model, base URL, webhook URL

Environment variables

See .env.example in the repository. Environment variables override config for LLM keys and runtime flags such as:

  • JOB_AGENT_MODE — search, assist-apply, demo, next-role, etc.
  • JOB_AGENT_HEADED — launch visible browser for portal login
  • JOB_AGENT_PORTAL — linkedin, naukri, or both
  • JOB_AGENT_RUN_ID — artifact suffix for a run (UI-managed)
  • JOB_AGENT_RESUME_RUN_ID — resume pipeline from checkpoint (UI-managed)
  • JOB_AGENT_UI_HOST — dashboard bind address (default 127.0.0.1)
  • JOB_AGENT_UI_PORT — dashboard port (default 3030)
  • OPENAI_API_KEY, OPENAI_BASE_URL, OPENAI_MODEL

Documentation ↔ dashboard

The product docs on vijayptiwari.github.io/meridian link back to your self-hosted workspace. After npm run ui, open http://127.0.0.1:3030.

If you bind Meridian to another host or port, visit any docs page once with ?dashboard=https://your-host:3030. The docs site remembers that URL in your browser for header, footer, and sidebar dashboard links.

Security

  • Never commit src/config.json or .env
  • The UI listens on 127.0.0.1 by default — do not expose it to the public internet without a reverse proxy and auth
  • Browser session state is stored in data/browser-state/ — treat it like a password
Use the in-app Setup checklist to see which steps remain before your first full run.