Environment variables are the third layer of configuration resolution — after code and before file-based defaults. They are convenient for CI and containers where writing a config file would be noisy.
Precedence
Reference table
| Name | Type | Default | Effect |
|---|---|---|---|
| NS_CACHE_DIR | path | ~/.cache/neuronscope | Where the recorder spools intermediate observations and where readers cache decoded tensors. |
| NS_LOG_LEVEL | string | warning | Root logger level. One of debug, info, warning, error, critical. |
| NS_DETERMINISTIC | bool | false | Refuses to run a recording if any installed op is known non-deterministic. |
| NS_MAX_OVERHEAD_PCT | int | 20 | Aborts a recording if measured overhead exceeds the percentage, before sealing. |
| NS_ARTIFACT_COMPRESS | string | zstd | Compression codec for .nsz observations. One of zstd, deflate, none. |
| NS_STORAGE_URL | url | file://. | Default artifact destination — file, s3, gs, or azure scheme. |
| NS_PLUGIN_PATH | path[] | — | Colon-separated extra directories the plugin loader scans. |
| NS_TELEMETRY | bool | false | Opt-in anonymous crash reports. Off by default; nothing leaves the machine unless enabled. |
| NS_COLOR | string | auto | CLI color mode. One of auto, always, never. |