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:8080Nodes need their packages in the executor image — extend it:
FROM exuvia
RUN uv pip install --python /opt/venv/bin/python scipy statsmodelsHosts 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.
| Env | Default | |
|---|---|---|
EXUVIA_EXECUTOR_URL / EXUVIA_EXECUTOR_TOKEN | local pool | remote executor + its token |
EXUVIA_SCHEDULER | internal | external = only POST /api/schedule/tick advances schedules |
EXUVIA_API_TOKEN | off | shared-secret auth for the control plane API |
EXUVIA_MAX_PARALLEL | 4 | concurrent node runs (control plane and executor) |
EXUVIA_RUN_TIMEOUT | 1800 | seconds before a node run is killed |
EXUVIA_BUNDLE_MAX_MB | 50 | max project size shipped to a remote executor |
EXUVIA_EXECUTOR_DIR | temp | executor scratch space |
EXUVIA_PROVIDER | auto | anthropic, openrouter, or openai (any OpenAI-compatible server) |
EXUVIA_MODEL | per provider | agent model (see below) |
EXUVIA_EFFORT | medium | Claude effort level |
EXUVIA_BASE_URL | OpenRouter | base URL for the openai provider (Ollama, vLLM, LiteLLM, …) |
EXUVIA_DB | per-project SQLite | where 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_STORE | local disk | s3://bucket/prefix: keep node outputs in an S3-compatible bucket, keyed <prefix>/<project>/<node>/<sha>.<ext> |
EXUVIA_S3_ENDPOINT | AWS | e.g. https://<account>.r2.cloudflarestorage.com or a MinIO URL |
EXUVIA_S3_REGION | AWS_REGION, then us-east-1 | signing region (auto for R2) |
EXUVIA_S3_ADDRESSING | path | virtual puts the bucket in the host name |
AWS_ACCESS_KEY_ID / AWS_SECRET_ACCESS_KEY / AWS_SESSION_TOKEN | — | bucket credentials (requests are SigV4-signed) |