Environment variables allow operators and CI pipelines to configure the NeuronScope platform without modifying application source code.
Precedence & Resolution
Environment Variable Reference
| Variable Name | Type | Default | Operational Effect |
|---|---|---|---|
| NS_CACHE_DIR | path | ~/.cache/neuronscope | Spooling directory for ring buffers and remote cloud tensor caching. |
| NS_LOG_LEVEL | string | warning | Logging verbosity (debug, info, warning, error, critical). |
| NS_DETERMINISTIC | bool | false | Enforces bit-exact reproducibility; fails on un-seeded CUDA ops. |
| NS_STRICT | bool | false | Enables strict mode for CI; rejects unverified model weights. |
| NS_GOVERNANCE_MODE | string | enforce | Governance policy mode (enforce, audit, off). |
| NS_BUFFER_MB | int | 256 | Lock-free ring buffer memory allocation limit in megabytes. |
| NS_IO_CONCURRENCY | int | 4 | Parallel thread count for streaming .nsz uploads to S3/GCS/Azure. |
| NS_ARTIFACT_COMPRESS | string | zstd | Compression codec for .nsz columns (zstd, deflate, none). |
| NS_STORAGE_URL | url | file://. | Default artifact URI (file, s3, gs, azure). |
| NS_PLUGIN_PATH | path[] | — | Colon-separated paths for custom enterprise plugins and adapters. |
| NS_COLOR | string | auto | CLI terminal formatting (auto, always, never). |