Reliquary

Clone the Reliquary repository

git clone https://github.com/reliquadotai/reliquary.git && cd reliquary

Create and activate Python 3.11+ virtual environment

python3.11 -m venv .venv && source .venv/bin/activate

Install Reliquary in development mode

pip install --upgrade pip && pip install -e .

Install pinned PyTorch, Transformers, and flash-attention versions matching validator stack

pip install torch==2.7.0 --index-url https://download.pytorch.org/whl/cu128 transformers==5.9.0 flash-attn==0.5.0

Create Bittensor wallet and register hotkey

btcli wallet new-coldkey --wallet.name my_miner && btcli wallet new-hotkey --wallet.name my_miner --wallet.hotkey default

Register hotkey on subnet 81 (finney testnet)

btcli subnet register --wallet.name my_miner --wallet.hotkey default --netuid 81

Set environment variables for current protocol profile and fill-closed window mode

export RELIQUARY_PROTOCOL_PROFILE=qwen3-4b-base-dapo-reliquary-v1 && export RELIQUARY_EXPERIMENTAL_FILL_CLOSED_ENABLED=1

Launch miner (validator-url required during subnet launch phase; auto-discovered after owner validator gains validator_permit)

reliquary mine --network finney --netuid 81 --wallet-name my_miner --hotkey default --checkpoint Qwen/Qwen3-4B-Base --environments openmathinstruct,opencodeinstruct --validator-url http://<validator-ip>:8888 --log-level INFO

Clone the Reliquary repository

git clone https://github.com/reliquadotai/reliquary.git && cd reliquary

Create and activate Python 3.12+ virtual environment

python3.12 -m venv .venv && source .venv/bin/activate

Install Reliquary with validator dependencies

pip install --upgrade pip && pip install -e .[validator]

Install pinned PyTorch, Transformers, and flash-attention stack

pip install torch==2.7.0 --index-url https://download.pytorch.org/whl/cu128 transformers==5.9.0 flash-attn==0.5.0

Set protocol profile and base checkpoint environment variables

export RELIQUARY_PROTOCOL_PROFILE=qwen3-4b-base-dapo-reliquary-v1 && export RELIQUARY_CHECKPOINT=Qwen/Qwen3-4B-Base

Configure proof GPU devices and capacity manifest (must be qualified for exact fleet)

export RELIQUARY_PROOF_DEVICES='cuda:0,cuda:1,...' && export RELIQUARY_PROOF_CAPACITY_MANIFEST=/path/to/proof-capacity.json

Configure HuggingFace Hub and Cloudflare R2 credentials for checkpoint publishing and archive storage

export RELIQUARY_HF_REPO_ID=<your-repo> && export HF_TOKEN=<token> && export R2_ACCOUNT_ID=<id> && export R2_ACCESS_KEY_ID=<key> && export R2_SECRET_ACCESS_KEY=<secret>

Launch validator (in-process training by default)

reliquary validate --network finney --netuid 81 --wallet-name my_validator --hotkey default

Enable detached trainer mode (optional; writes payloads to R2 and skips in-process training)(optional)

export RELIQUARY_WRITE_TRAINING_PAYLOADS=1 && export RELIQUARY_DETACHED_TRAINER=1

Launch detached H100 trainer worker on separate box (if using detached mode)(optional)

reliquary train-worker --validator-url http://localhost:8000