.env.example

# Copy to a file outside the repo (or to .env, which is gitignored) and source it.
# Nothing here has a value baked into the code — every secret is read from the
# environment, and no default points at anybody's account.

# ---- where the code and its weights live ----------------------------------
export SOLAR_WM_ROOT=/path/to/solarwm-data           # repo root (default: inferred)
export SOLAR_WM_WEIGHTS="$SOLAR_WM_ROOT/weights"     # model weights cache
export SOLAR_WM_SCRATCH=/fast/local/disk/solarwm     # per-worker scratch (needs ~100 GB)
export HF_HOME="$SOLAR_WM_WEIGHTS/hf"

# ---- output spec ----------------------------------------------------------
export SOLAR_WM_SPEC=5s        # 5s=121@24 | 60s=1437@24 | 81f=81@16 | 160f=160@16 | 960f=960@16
                               # or any inline <frames>@<fps>, e.g. 241@24
                               # `solarwm-pipeline spec list` prints the catalogue
                               # fps comes WITH the spec; do not set SOLAR_WM_TARGET_FPS unless
                               # you mean to override it (a stale value silently mis-times clips)
export SOLAR_WM_RUN_ID=5s      # namespaces the corpus prefix AND the done-markers
export SOLAR_WM_STORE_ALL=1    # keep rejected clips too, with their annotations and reasons.
                               # This is the default and the engine's premise; =0 discards
                               # them at the moment of the verdict, unrecoverably.
export SOLAR_WM_FILTERS_CFG=filters   # which configs/<name>.yaml judges this run
                                      # `filters_released` = the released corpus's policy

# ---- corpus sink: pick ONE backend ----------------------------------------
export SOLAR_WM_STORAGE=local  # local | s3 | cos
export SOLAR_WM_CORPUS_PREFIX=corpus

# local: no object store, keys map to files under this root
export SOLAR_WM_LOCAL_ROOT=/shared/filesystem/solarwm

# s3
# export SOLAR_WM_S3_BUCKET=my-bucket
# export AWS_REGION=us-west-2
# export AWS_ACCESS_KEY_ID=... ; export AWS_SECRET_ACCESS_KEY=...

# cos
# export SOLAR_WM_COS_BUCKET=my-bucket-appid
# export SOLAR_WM_COS_REGION=<region>
# export SOLAR_WM_COS_ENDPOINT=           # optional custom endpoint
# export COS_SECRET_ID=... ; export COS_SECRET_KEY=...

# ---- raw sources ----------------------------------------------------------
export HF_TOKEN=                     # needed for the gated datasets
# export SOLAR_WM_SPATIALVID_HQ=1     # full SpatialVID-HQ (gated). Without it the acquire
                                      # falls back to a much smaller ungated mirror.
# export SOLAR_WM_MIRA_REPO=          # MiraData shard repo (default: Enderfga/Mira)
# export SOLAR_WM_MIND_REPO=          # MIND (default: CSU-JPG/MIND)
# export SOLAR_WM_ABOT_REPO=          # ABot-World-Explorer

# ---- build-time -----------------------------------------------------------
# The setup scripts JIT-compile CUDA extensions against the torch the venv inherits,
# so they check the host torch version. Override if your base image ships another.
# export SOLAR_WM_EXPECT_TORCH=2.8

# ---- VLM annotation stage (any OpenAI-compatible endpoint) ----------------
# Captions come from a SEPARATE pass over produced clips, not from the fleet run.
# export SOLAR_WM_VLM_URL=https://<host>/v1/chat/completions
# export SOLAR_WM_VLM_MODEL=<model-id>
# export SOLAR_WM_VLM_API_KEY=
# export SOLAR_WM_VLM_KEY_FILE=       # read the key from a file instead

# ---- multi-worker launches -------------------------------------------------
# The fan-out launcher sources this file; point it at wherever you keep it.
# export SOLAR_WM_COS_ENV="$HOME/.solarwm.env"