Shared (both SDKs)
| Variable | Description |
|---|---|
| ROLLOUT_API_KEY | Workspace API key. |
| ROLLOUT_BASE_URL | Override the ingest endpoint (local or self-hosted). |
| ROLLOUT_ENVIRONMENT | Deployment environment, e.g. production. |
| ROLLOUT_RELEASE | App version or git SHA. |
| ROLLOUT_SERVICE_NAME | Service identifier. |
| ROLLOUT_AGENT_NAME | Agent name. |
| ROLLOUT_AGENT_ID | Agent ID. |
| ROLLOUT_AGENT_VERSION | Agent version. |
| ROLLOUT_DEPLOYMENT | Deployment slot or region. |
| ROLLOUT_SAMPLE_RATE | Trace sample rate, 0.0–1.0. |
| ROLLOUT_DEBUG | Verbose logging (true/false). |
| ROLLOUT_DISABLED | Disable the SDK entirely (true/false). |
Python SDK
The Python SDK reads all of the shared variables above. See Configuration for the matching constructor parameters and advanced options.
TypeScript SDK
The TypeScript SDK reads the same shared variables. See TypeScript configuration for constructor options and the scrubber / beforeSend pipeline.
CLI
| Variable | Description |
|---|---|
| ROLLOUT_CONFIG_DIR | Directory holding config.json. |
| ROLLOUT_APP_URL | Browser app URL. |
| ROLLOUT_API_URL | API URL used by whoami, check, and imports. |
| ROLLOUT_BASE_URL | Single-origin shorthand for app + API. |
| ROLLOUT_API_KEY | Workspace API key. |
See CLI configuration for file location and permissions.
Optimization runner
| Variable | Description |
|---|---|
| ROLLOUT_GEPA_REFLECTION_MODEL | Model GEPA uses to propose prompts (--reflection-model). |
| ROLLOUT_GEPA_STUDENT_MODEL | Optional DSPy task / student model (--task-model). |
| ROLLOUT_GEPA_CONCURRENCY | Parallel LLM calls in eval and search (--concurrency, default 4). |
| OPENAI_API_KEY / OPENROUTER_API_KEY | Provider keys your target uses. Never sent to Rollout. |
See Running & watching runs for the matching flags and the litellm prefix rule for OpenRouter models.