Orchestrator environment variables
Every environment variable the orchestrator, its shipped config, the desktop daemon and the public-mesh auditor read, with defaults.
Secrets go in the environment (a gitignored .env in a checkout, your secret store in production), never in orchestrator.yaml: the config names a variable (api_key_env: OPENAI_API_KEY) and the orchestrator reads it at load. Keys are never logged or returned by the admin API.
The shipped config refers to variables with ${VAR} or ${VAR:-default}; you can use the same syntax for any value in your own file.
Process
| Variable | Default | What it does |
|---|---|---|
VENOM_CONFIG |
config/orchestrator.yaml |
The config file. |
VENOM_PRICES |
prices.yaml next to the config |
The price table. Missing: every cost is $0, with a warning. |
VENOM_MODEL_CATALOG |
model-catalog/ next to the config |
Directory of model-catalog shards served at GET /api/models/providers/{id}. |
VENOM_DATA_DIR |
./data |
SQLite database (keys, request log, spend ledger, batches, files) and state files. |
VENOM_LISTEN |
127.0.0.1:8787 |
Listen address, read by the shipped config's listen:. |
VENOM_API_KEY |
none | The bootstrap client key accepted on /v1/*. More keys come from POST /admin/v1/keys. |
VENOM_ADMIN_TOKEN |
none | Bearer token for /admin/v1/*; unset, the admin API answers 503. |
VENOM_ALLOW_OPEN |
unset | 1 lets the orchestrator run with no client key on a non-loopback address. Without it that combination refuses to start. |
LOG_LEVEL |
info |
debug, info, warn or error. |
LOG_JSON |
unset | 1 for JSON logs. |
VENOM_CASSETTE_MODE |
off |
record writes every complete 200 to a cassette; replay answers from cassettes and never calls an upstream (Operations). |
VENOM_CASSETTE_DIR |
$VENOM_DATA_DIR/cassettes |
Where cassettes live. |
VENOM_ORCH_URL |
http://localhost:8787 |
Not read by the orchestrator: where the web console, the eval runner and backtest scripts reach its admin API. |
OTEL_EXPORTER_OTLP_ENDPOINT, OTEL_EXPORTER_OTLP_HEADERS, OTEL_EXPORTER_OTLP_PROTOCOL |
unset (off) | OpenTelemetry trace export over OTLP/HTTP. Spans never carry prompt or reply content. |
Providers in the shipped config
Every cloud upstream is disabled while its key variable is empty, so nothing calls that provider.
| Variable | Default | What it does |
|---|---|---|
OPENAI_API_KEY |
none | The openai upstream. |
ANTHROPIC_API_KEY |
none | The commented-out anthropic upstream. |
ZAI_API_KEY |
none | The zai upstream (aliases glm, glm-fast, glm-vision, a venom-fast fallback). |
ZAI_BASE_URL |
https://api.z.ai/api/paas/v4 |
https://api.z.ai/api/coding/paas/v4 for the GLM Coding Plan. |
QWEN_API_KEY |
none | The qwen upstream (kind dashscope: aliases qwen, qwen-fast, qwen-coder, qwen-vision, deepseek, kimi, and glm's first target). |
QWEN_BASE_URL |
https://dashscope-intl.aliyuncs.com/compatible-mode/v1 |
Another Model Studio region's endpoint (a key from that region). |
MISTRAL_API_KEY, MISTRAL_BASE_URL |
none, https://api.mistral.ai/v1 |
The commented-out mistral upstream. |
MINIMAX_API_KEY, MINIMAX_BASE_URL |
none, https://api.minimax.io/v1 |
The commented-out minimax upstream; https://api.minimaxi.com/v1 for mainland China. |
TYPESAFE_API_KEY |
none | The typesafe decision upstream (alias venom-decide); unset, the alias is not listed. |
TYPESAFE_BASE_URL |
https://api.typesafe.ai/v1 |
Its endpoint. |
AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY, AWS_SESSION_TOKEN, AWS_REGION |
none | IAM credentials and region for bedrock and sagemaker upstreams; each upstream's aws: block can name other variables. |
SEARXNG_URL |
empty (skipped) | The SearxNG instance POST /v1/search asks first. |
BRAVE_API_KEY, TAVILY_API_KEY, EXA_API_KEY |
none | Search backends in /v1/search's chain; each is skipped without its key. |
Local engines
| Variable | Default | What it does |
|---|---|---|
OLLAMA_BASE_URL |
http://localhost:11434/v1 |
The ollama upstream (make up points it at the container or a host Ollama). |
OLLAMA_CONTEXT_LENGTH |
32768 |
The context window declared for Ollama models (Ollama truncates silently past its own setting, so keep them equal). |
VENOM_OLLAMA_MODEL |
qwen3:8b |
The Ollama model behind venom-default and venom-smart's local target. |
VENOM_OLLAMA_FAST_MODEL |
qwen3:4b |
The Ollama model behind venom-fast. |
VENOM_OLLAMA_EMBED_MODEL |
qwen3-embedding:0.6b |
The only target of venom-embed. |
VENOM_OLLAMA_VISION_MODEL |
qwen2.5vl:7b |
venom-vision's last (local) target. |
VLLM_BASE_URL |
http://localhost:8000/v1 |
The vllm upstream. |
VLLM_MODEL |
Qwen/Qwen3-Coder-30B-A3B-Instruct |
The model vLLM serves, first target of venom-default, venom-fast and venom-smart. |
VLLM_MAX_MODEL_LEN |
0 (discovered) |
vLLM's context window when you want to pin it. |
VENOM_LLMFIT_URL, VENOM_LLMFIT_BIN |
none, then llmfit on PATH |
Where /admin/v1/local reads hardware and fit estimates: an llmfit serve, else the binary. |
VENOM_DOCKER_BIN |
docker on PATH |
The Docker CLI the one-click vLLM (POST /admin/v1/local/serve) runs. |
VENOM_VLLM_IMAGE |
vllm/vllm-openai:v0.31.0 |
The image it starts. |
Computers
Venom Computers gives each agent a persistent browser on this machine (how it works). Off unless VENOM_COMPUTERS=on, and only with Docker on the PATH and an orchestrator that is not itself in a container.
| Variable | Default | What it does |
|---|---|---|
VENOM_COMPUTERS |
off | on turns it on. |
VENOM_SOURCE_DIR |
the working directory or the executable's, or a parent | The repo checkout that holds deploy/computer/Dockerfile, so one-click Enable Computers can build the image when the published one is not available. |
VENOM_COMPUTERS_IMAGE |
venom-computer:dev |
The host image. Unset: the digest linked into a release build, else the local build (make computer-image). Wins over both. See Run Computers on your own daemon. |
VENOM_COMPUTERS_MEMORY |
half the machine's RAM | The RAM active seats may use (8g, 512m). max_active is the lower of VENOM_COMPUTERS_MAX_ACTIVE and this divided by the memory per active seat. |
VENOM_COMPUTERS_MAX_ACTIVE |
0 (the RAM budget alone) |
A cap on seats with a running browser. |
VENOM_COMPUTERS_MAX_SEATS |
100 |
Seats this daemon provisions (profiles on disk). |
VENOM_COMPUTERS_SEATS_PER_HOST |
25 |
Seats per host container. A private seat gets a host of its own. |
VENOM_COMPUTERS_QUEUE_MAX |
200 |
Starts that may wait for a slot before the next one is refused with 429. |
VENOM_COMPUTERS_IDLE_AFTER |
10m |
Quiet time (no tool call, nobody watching) before a seat hibernates. |
VENOM_COMPUTERS_MEM_PER_SEAT_MIB |
450 |
The starting estimate of memory per active browser seat; it follows what the hosts report. |
VENOM_COMPUTERS_DESKTOP_MEM_PER_SEAT_MIB |
500 |
The same for a desktop seat (an X display, a window manager, a headful browser and its apps). |
VENOM_COMPUTERS_HOST_MEMORY, VENOM_COMPUTERS_HOST_CPUS |
RAM budget capped at 16 GiB, 4 |
The --memory and --cpus of each host container. |
VENOM_COMPUTERS_PROXY |
none | The --proxy-server for every seat's Chromium (the guard/egress proxy). |
VENOM_COMPUTERS_SERVE_BIN |
the desktop daemon's bin/venom, else venom |
The binary run as venom serve for a seat's agent sessions. |
A model chosen with POST /admin/v1/local/select sets VENOM_OLLAMA_MODEL or VENOM_OLLAMA_FAST_MODEL in the running process and is kept in $VENOM_DATA_DIR/local-models.json.
Mesh mode
Mesh mode connects the orchestrator to Venom Cloud as a daemon. It only dials out, and none of these is read unless VENOM_CLOUD_URL is set (or the dashboard connects with POST /admin/v1/mesh/connect).
| Variable | Default | What it does |
|---|---|---|
VENOM_CLOUD_URL |
unset (mesh off) | The cloud to join, with the credential orchestrator mesh join <url> <vjt_…> wrote to $VENOM_DATA_DIR/mesh/. |
VENOM_MESH_JOIN_TOKEN |
none | A vjt_… join token used at start when no credential exists yet (containers). Never written to disk. |
VENOM_MESH_NAME |
the host name | The daemon's name in the cloud console. |
VENOM_MESH_ENDPOINTS |
none (relay only) | Reachable endpoints, kind=url[,network] separated by ;, for direct connections. |
VENOM_MESH_GEO |
inferred from the time zone | The daemon's location; none reports none. |
VENOM_MESH_ACCEPT_TEAMS |
empty (no allowlist) | Comma-separated team allowlist: jobs from other teams are refused. |
VENOM_MESH_MAX_JOBS |
the sum of the upstreams' max_inflight |
Concurrent cloud jobs (a positive integer). |
VENOM_MESH_GPUS |
none | GPUs reported in the daemon's capabilities, e.g. RTX 4090:24. |
VENOM_MESH_SERVE_URL |
none | Forward remote venom serve sessions to the venom serve at that URL (needs VENOM_SERVER_TOKEN). |
VENOM_MESH_SERVE_FILE |
none | A JSON file whose serve_url names the local venom serve, re-read while the orchestrator runs, so serve can start, stop or move without a restart; no serve_url, no serve. Needs VENOM_SERVER_TOKEN; VENOM_MESH_SERVE_URL wins. The desktop daemon points it at its run.json (Projects). |
A malformed VENOM_MESH_* value stops the start; a failed join or a revoked credential leaves mesh off and the local /v1 serving. The protocol is covered with Venom Cloud and the mesh.
Desktop daemon
Set by the venom-daemon launcher; you rarely set them yourself.
| Variable | Default | What it does |
|---|---|---|
VENOM_DAEMON_LAUNCHER |
none | The launcher's path; turns on start at login in /admin/v1/daemon. |
VENOM_DAEMON_HOME |
the install root | Where the daemon's binaries live. |
VENOM_DAEMON_DIR |
~/.venom/daemon (%LOCALAPPDATA%\Venom on Windows) |
The daemon's state directory. |
VENOM_DAEMON_NODE |
the bundled Node.js | The Node binary the launcher runs the console with. |
VENOM_DAEMON_UPDATE_URL |
https://github.com/elishahbiz/venom-releases/releases |
Releases base URL for the opt-in auto-update (a mirror works). |
VENOM_DAEMON_UPDATE_IDLE, VENOM_DAEMON_UPDATE_MAX_WAIT |
30s, 30m |
The idle window an update waits for, and its cap. |
Public-mesh auditor
venom-auditor (a separate binary run by the public mesh's operators) replays sampled public jobs on reference vLLMs and sends canaries. It needs VENOM_CLOUD_URL and its auditor token.
| Variable | Default | What it does |
|---|---|---|
VENOM_AUDITOR_REFERENCES |
required for audits | Comma-separated [id=]url[#model] reference vLLMs; the second runs confirmation reruns. |
VENOM_AUDITOR_LISTEN |
127.0.0.1:9797 |
Its /health and /metrics; off for none. |
VENOM_AUDITOR_CORPUS |
none | A directory of task.json prompts and source files for canaries. |
VENOM_AUDITOR_CONCURRENCY |
2 |
Audits replayed at once. |
VENOM_AUDITOR_POLL |
10s |
Wait when no audit is pending. |