Skip to content

app

app

Theseus Web UI - FastAPI application.

Usage

uvicorn theseus.web.app:app --reload --host 0.0.0.0 --port 8000

Or via CLI

theseus web --cluster-root /path/to/cluster/root

create_app(cluster_root: Optional[Path] = None, debug: bool = False, cache_mode: Optional[str] = None, cache_poll_interval: Optional[float] = None) -> FastAPI

Create the FastAPI application.

Parameters:

Name Type Description Default
cluster_root Optional[Path]

Root directory of the cluster (contains status/, checkpoints/, etc.)

None
debug bool

Enable debug mode

False
cache_mode Optional[str]

Job cache mode - "polling" (default, JuiceFS-safe), "watchdog" (native fs events, best for local dev), or "off" to disable. Can also be set via THESEUS_CACHE_MODE env var.

None
cache_poll_interval Optional[float]

Seconds between cache poll cycles (default 10). Can also be set via THESEUS_CACHE_POLL_INTERVAL env var.

None