Running the UI API

Running the UI API

This command starts the read-only UI API based on FastAPI.

Install UI dependencies

uv sync --extra ui

Start

uv run loreley api

This command requires DATABASE_URL to point at a Loreley database with an instance metadata marker (created by uv run loreley reset-db --yes).

Options

• --host: bind host (default: 127.0.0.1)
• --port: bind port (default: 8000)
• --log-level: global option (pass before the subcommand) that overrides LOG_LEVEL for this invocation
• --reload: enable auto-reload (development only)

Logs

Logs are written to:

• logs/{experiment_namespace}/ui_api/ui_api-YYYYMMDD-HHMMSS.log