Loading
Loading

This information was auto-extracted from the GitHub repository and may be incomplete or out of date. Always refer to the subnet's GitHub repository for the latest instructions.
Two GPUs recommended (generation + proof on separate devices); one larger device also works. Must match validator's pinned inference stack: Torch 2.7.0+cu128, Transformers 5.9.0, flash-linear-attention 0.5.0, no causal-conv1d. CUDA 12.x with flash-attn-compatible drivers required. No R2/S3 credentials needed.
Proof capacity depends on p95 group-proof latencies. Minimum homogeneous H100 count formula: ceil(18 * (M_p95 + C_p95) / (240 * 0.8)). Plan 8-10 H100s for Qwen3-4B long-context workload. Validator owns proof scheduling, GRAIL verification, training, checkpoint publication, and R2 archiving. Detached trainer can run on separate box with GPU + HF/R2 access.
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