Skip to main content

evalstudio serve

Start the EvalStudio API server and web UI in a single process.

Usage​

evalstudio serve [options]

Options​

OptionDescriptionDefault
-p, --port <number>Port to listen on3000 (or EVALSTUDIO_PORT env var)
--no-webDisable web UI (API only)Web enabled
--no-processorDisable background run processorProcessor enabled
--openOpen browser after startingDisabled

Examples​

Start with defaults​

evalstudio serve

Output:

  EvalStudio server started
API: http://127.0.0.1:3000/api
Web: http://127.0.0.1:3000
Run processor: enabled

Custom port​

evalstudio serve --port 8080

Or using the environment variable:

EVALSTUDIO_PORT=8080 evalstudio serve

API only (no web UI)​

evalstudio serve --no-web

Open browser automatically​

evalstudio serve --open

Via npx (no global install)​

npx evalstudio serve

Environment Variables​

VariableDescription
EVALSTUDIO_PORTDefault port for the server (overridden by --port flag)

Architecture​

The serve command starts a single Fastify server that:

  1. API routes — All REST endpoints served under /api prefix
  2. Web UI — Built React app served as static files with SPA fallback
  3. Run processor — Background service that polls and executes queued runs

The web UI assets are embedded in the CLI package at build time, so no separate web server is needed.