.env.template

# Copy to `.env` and fill in. Loaded automatically via python-dotenv
# (find_dotenv walks up from the working directory). Never commit `.env`.

# ── PharmVar (enricher pgx pass) ─────────────────────────────────────────────
# Sent as the `Api-Key` header (not `X-API-KEY`). Personal under PharmVar ToS §2 —
# never bake into a module, fixture, or snapshot. Absent → PharmVar leg skipped.
PHARMVAR_API_KEY=

# ── NCBI / literature ────────────────────────────────────────────────────────
# Optional. Tightens PubMed/dbSNP pacing from ~1/3s to ~1/10s.
NCBI_API_KEY=
# Polite-pool contact for NCBI and Europe PMC; omitted when unset.
JUST_DNA_CONTACT_EMAIL=

# ── Hugging Face (snapshot download / module upload) ─────────────────────────
# Write token for `upload` / publisher; `hf auth login` also works.
HF_TOKEN=

# ── Snapshot caches (enricher locations) ─────────────────────────────────────
# Base for every cache below (else platformdirs ~/.cache/just-dna-pipelines).
# JUST_DNA_PIPELINES_CACHE_DIR=
# Override one cache path. `just-dna-enricher cache status` reports what is found;
# `cache pull` provisions the published ones from HuggingFace.
# JUST_DNA_ENSEMBL_CACHE=
# JUST_DNA_CLINVAR_CACHE=
# JUST_DNA_GNOMAD_CONSTRAINT_CACHE=
# The licence-gated three (RM38) — a hosted enricher must not reach these live per request.
# ClinPGx and CPIC can be pulled; PharmVar is operator-built only (personal key, terms §2).
# JUST_DNA_CLINPGX_CACHE=
# JUST_DNA_CPIC_CACHE=
# JUST_DNA_PHARMVAR_CACHE=

# ── Retry persistence (RM42) ─────────────────────────────────────────────────
# A FLOOR, not a setting: raises every live client to at least this many attempts and
# never lowers one, so gnomAD/eutils keep their higher default of 4. Unset = each
# client's own number (3, or 4). Raise it for an unattended server-side publish.
# JUST_DNA_HTTP_RETRY_ATTEMPTS=

# ── Tests ────────────────────────────────────────────────────────────────────
# Opt-in live network probes (gnomAD, seqrepo, indel minting). Off by default.
# JUST_DNA_NETWORK_TESTS=1