.env.example

# Ralph environment configuration
# Copy to .env and fill in your values:  cp .env.example .env

# ---- Chain backend ----
# "local" = JSON-file ledger (testing)
# "bittensor" = real Bittensor testnet/mainnet
RALPH_CHAIN=local

# ---- Bittensor (only needed when RALPH_CHAIN=bittensor) ----
BT_NETWORK=test                    # "test" for testnet, "finney" for mainnet
BT_NETUID=                         # your subnet netuid (assigned at registration)
BT_WALLET=default                  # wallet name (btcli wallet list)
BT_HOTKEY=default                  # hotkey name

# ---- wandb ----
# All Ralph miner runs log to the central ralphlabs-hub entity for a unified
# network view. Each miner needs WANDB_API_KEY (their own personal key);
# membership on the ralphlabs-hub team grants write access.
WANDB_ENTITY=ralphlabs-hub       # central ralph observability entity
WANDB_PROJECT=ralph            # project name
# WANDB_API_KEY=               # set per-miner, never commit

# ---- HuggingFace ----
HF_TOKEN=                          # write token for RalphLabsAI/proof-bundles
RALPH_HF_REPO=RalphLabsAI/proof-bundles

# ---- GitHub: PR submission (miner side) ----
# When set, scripts/miner_run.py pushes the patched branch to RALPH_RECIPE_FORK
# and opens a PR against RALPH_RECIPE_UPSTREAM. Submission.json carries pr_url.
RALPH_MINER_GH=                    # your GitHub username (also used as wandb tag)
RALPH_MINER_GH_TOKEN=              # PAT with public_repo scope on your fork
RALPH_RECIPE_FORK=                 # e.g. https://github.com/<you>/recipe.git
RALPH_RECIPE_UPSTREAM=RalphLabsAI/recipe

# ---- GitHub: PR merge / tag / release (validator side) ----
# When set, validator/service.py squash-merges the winning PR, tags
# recipe-vX.Y.Z, and publishes a release with the metrics body. Recommend
# a dedicated ralph-bot account; PAT needs public_repo on RalphLabsAI/recipe.
RALPH_BOT_GH_TOKEN=

# ---- Recipe repo ----
# The canonical training recipe lives in a separate repo (RalphLabsAI/recipe).
# Default resolution: ../recipe (sibling of the ralph checkout).
# Override here if you clone it somewhere else.
# RALPH_RECIPE_DIR=/path/to/RalphLabsAI/recipe

# ---- Shadeform GPU rental ----
# API key stored separately at /root/.shadeform_api_key (not here)
SHADEFORM_SSH_KEY_ID=              # optional: your ssh key ID on Shadeform