All zorp environment variables use the ZORP_ prefix. A setting saved
in the web UI beats the matching variable, which beats the built-in
default.
Variable Default What it does
ZORP_BASE_URLnone OpenAI-compatible endpoint, hosted or local ZORP_API_KEYnone API key. Never written to disk by the web UI ZORP_MODELnone Model name ZORP_HTTP_TIMEOUT_SECS900 Seconds of silence to wait for. On a streamed reply this bounds the gap between chunks, not the length of the answer ZORP_RETRY_ATTEMPTS4 Total sends for a request answered 429, 502 or 503, on the status line or as an error object inside a 200 before anything reached the caller. Nothing else is retried ZORP_RETRY_BUDGET_SECS30 Seconds of added waiting the retries may spend in total ZORP_CONTEXT_TOKENSunset Context window size. Unknown unless you say, on purpose
Variable Default What it does
ZORP_FORECASTunset Ask for a forecast before each investigate attempt and record it ZORP_CRITIQUE_ROUNDS2 Bound on critique’s revision rounds ZORP_TAVILY_API_KEYnone Enables the web_search built-in (with the search feature)
Variable Default What it does
ZORP_WEB_TOKENnone Required when binding anything but loopback ZORP_WORKSPACEcwd Directory the agent works in and the Files pane shows ZORP_SESSION_TITLES1 Set 0 to keep the verbatim first message as the sidebar label ZORP_SKILLS_DIRunset Extra skills directory, wins over user and repo skills
Variable Default What it does
ZORP_RECALL_SWEEP_SECS300 Full-store index sweep interval. 0 disables sweeps ZORP_RECALL_DBnext to the session store Where the vector index lives ZORP_EMBED_URLlocal Ollama Embedding endpoint. Must be loopback; a remote host gets a refusal, not a remote embedder ZORP_EMBED_MODELnomic-embed-textEmbedding model ZORP_VOICE_URLhttp://127.0.0.1:8000ASR endpoint. Loopback only ZORP_VOICE_MODELQwen/Qwen3-ASR-0.6BASR model ZORP_VOICE_AUTOSTART1 Set 0 to disable every install and spawn step
Variable Default What it does
ZORP_INSTALL_DIR~/.local/binWhere binaries land ZORP_INSTALL_FROM_SOURCEunset Set 1 to force a source build
This table tracks the README and can lag it. When in doubt, the README
and --help win.