Run

Deploying

docker build -t exuvia .
# executor (default command)
docker run -p 8080:8080 -e EXUVIA_EXECUTOR_TOKEN=change-me exuvia
# control plane on your machine, nodes running in the container
EXUVIA_EXECUTOR_TOKEN=change-me exuvia serve my-project --executor http://localhost:8080

Nodes need their packages in the executor image — extend it:

FROM exuvia
RUN uv pip install --python /opt/venv/bin/python scipy statsmodels

Hosts that sleep or scale to zero. An in-process scheduler can't fire while its process is asleep. Run the control plane with --scheduler external and have something call POST /api/schedule/tick every minute or so: a Cloudflare Durable Object alarm or Cron Trigger, a Kubernetes CronJob, or system cron. Ticks are idempotent; fires missed while asleep are coalesced into one catch-up run, and paused schedules skip their backlog.

Auth. Set EXUVIA_API_TOKEN on a hosted control plane: API clients send Authorization: Bearer <token>; browsers open /?token=<token> once and get an HttpOnly cookie. Always set EXUVIA_EXECUTOR_TOKEN on a networked executor — it runs arbitrary code by design.

EnvDefault
EXUVIA_EXECUTOR_URL / EXUVIA_EXECUTOR_TOKENlocal poolremote executor + its token
EXUVIA_SCHEDULERinternalexternal = only POST /api/schedule/tick advances schedules
EXUVIA_API_TOKENoffshared-secret auth for the control plane API
EXUVIA_MAX_PARALLEL4concurrent node runs (control plane and executor)
EXUVIA_RUN_TIMEOUT1800seconds before a node run is killed
EXUVIA_BUNDLE_MAX_MB50max project size shipped to a remote executor
EXUVIA_EXECUTOR_DIRtempexecutor scratch space
EXUVIA_PROVIDERautoanthropic, openrouter, or openai (any OpenAI-compatible server)
EXUVIA_MODELper provideragent model (see below)
EXUVIA_EFFORTmediumClaude effort level
EXUVIA_BASE_URLOpenRouterbase URL for the openai provider (Ollama, vLLM, LiteLLM, …)
EXUVIA_DBper-project SQLitewhere run history, schedules, sessions and code revisions live: sqlite:///<path> or postgresql://…
EXUVIA_DB_SCOPE—prefix for project scopes in a shared EXUVIA_DB (e.g. a user id)
EXUVIA_ARTIFACT_STORElocal disks3://bucket/prefix: keep node outputs in an S3-compatible bucket, keyed <prefix>/<project>/<node>/<sha>.<ext>
EXUVIA_S3_ENDPOINTAWSe.g. https://<account>.r2.cloudflarestorage.com or a MinIO URL
EXUVIA_S3_REGIONAWS_REGION, then us-east-1signing region (auto for R2)
EXUVIA_S3_ADDRESSINGpathvirtual puts the bucket in the host name
AWS_ACCESS_KEY_ID / AWS_SECRET_ACCESS_KEY / AWS_SESSION_TOKEN—bucket credentials (requests are SigV4-signed)