Environment Variables
Pyvorin reads configuration from the environment first, then the config file, then safe defaults. No secrets are required in environment variables for normal operation.
Thin Client Variables
All PYVORIN_THIN_* variables override the corresponding config file fields.
| Variable | Type | Default | Description |
|---|---|---|---|
PYVORIN_THIN_API_BASE_URL | string | https://api.pyvorin.com | Base URL for all API endpoints. |
PYVORIN_THIN_COMPILE_API_URL | string | (derived) | Override the compile endpoint. |
PYVORIN_THIN_LICENSE_API_URL | string | (derived) | Override the licence endpoint. |
PYVORIN_THIN_USAGE_API_URL | string | (derived) | Override the usage endpoint. |
PYVORIN_THIN_REQUEST_TIMEOUT_SECONDS | float | 10.0 | HTTP request timeout. |
PYVORIN_THIN_REQUEST_RETRY_LIMIT | int | 2 | Number of retries on transient failures. |
PYVORIN_THIN_MOCK_MODE | bool | false | Enable mock mode for offline development. |
PYVORIN_THIN_ALLOW_LOCAL_FALLBACK | bool | false | Allow local CPython fallback. |
PYVORIN_THIN_CACHE_DIR | string | (platform default) | Directory for compiled artifact cache. |
PYVORIN_THIN_USAGE_OUTPUT_DIR | string | (platform default) | Directory for local usage event JSON. |
PYVORIN_THIN_TELEMETRY_ENABLED | bool | true | Enable or disable telemetry. |
PYVORIN_THIN_FAILURE_REPORTS_ENABLED | bool | true | Enable failure report uploads. |
PYVORIN_THIN_BENCHMARK_REPORTS_ENABLED | bool | true | Enable benchmark report uploads. |
PYVORIN_THIN_SOURCE_UPLOAD_DISABLED | bool | true | Disable raw source upload by default. |
PYVORIN_THIN_OFFLINE_QUEUE_ENABLED | bool | true | Queue events locally when offline. |
PYVORIN_THIN_MAX_QUEUE_SIZE | int | 1000 | Maximum number of queued event files. |
PYVORIN_THIN_QUEUE_RETENTION_DAYS | int | 30 | Days to retain queued events. |
PYVORIN_THIN_QUEUE_DIR | string | (platform default) | Directory for the offline queue. |
PYVORIN_THIN_CUSTOMER_ID | string | (empty) | Customer identifier (hashed before transmission). |
PYVORIN_THIN_PROJECT_ID | string | (empty) | Project identifier (hashed before transmission). |
PYVORIN_THIN_LICENSE_KEY | string | (empty) | Override the stored licence key. |
PYVORIN_THIN_CONFIG_PATH | string | (platform default) | Path to the config JSON file. |
PYVORIN_THIN_SEND_SOURCE | string | (not set) | Set to 1 to confirm raw source upload. |
Native Compiler Variables
These apply when the full pyvorin package is installed and used directly.
| Variable | Default | Description |
|---|---|---|
PYVORIN_BACKEND | auto | Default backend mode: native, legacy, or auto. |
PYVORIN_ALLOW_LEGACY | (unset) | Allow fallback to the legacy backend. |
PYVORIN_FORCE_FALLBACK | (unset) | Force CPython compatibility execution. |
PYVORIN_BENCHMARK_MODE | (unset) | Skip licence checks during benchmark runs. |
PYVORIN_SKIP_LICENSE | (unset) | Skip licence validation (development only). |
PYVORIN_DEV_MODE | (unset) | Enable development mode (relaxes some checks). |
PYVORIN_LOCAL_NATIVE | (unset) | Enable local native compilation in thin client. |
PYVORIN_ENV | (unset) | Set to development to allow HTTP URLs. |
Precedence
Environment variables override config file values. Config file values override built-in defaults. Use pyvorin-thin config-show to inspect the resolved settings.