Skip to content

Latest commit

 

History

History
113 lines (75 loc) · 3.41 KB

Validating.md

File metadata and controls

113 lines (75 loc) · 3.41 KB
Raw

Validator Guide

Table of Contents

  1. Installation 🔧
  2. Validating ✅

Before you proceed ⚠️

Ensure you are running Subtensor locally to minimize outages and improve performance. See Run a Subtensor Node Locally.

Be aware of the minimum compute requirements for our subnet, detailed in Minimum compute YAML configuration.

Installation

Download the repository and navigate to the folder.

git clone https://github.com/bitmind-ai/bitmind-subnet.git && cd bitmind-subnet

We recommend using a Conda virtual environment to install the necessary Python packages.
You can set up Conda with this quick command-line install, and create a virtual environment with this command:

conda create -y -n bitmind python=3.10

To activate your virtual environment, run conda activate bitmind. To deactivate, conda deactivate.

Install the remaining necessary requirements with the following chained command.

conda activate bitmind
export PIP_NO_CACHE_DIR=1
chmod +x setup_validator_env.sh 
./setup_validator_env.sh

Data

You can download the necessary datasets by running:

python bitmind/download_data.py

We recommend you do this prior to registering and running your validator. Please note the minimum storage requirements specified in min_compute.yml.

Registration

To validate on our subnet, you must have a registered hotkey.

Mainnet

btcli s register --netuid 34 --wallet.name [wallet_name] --wallet.hotkey [wallet.hotkey] --subtensor.network finney

Testnet

btcli s register --netuid 168 --wallet.name [wallet_name] --wallet.hotkey [wallet.hotkey] --subtensor.network test

Validating

You can launch your validator with run_neuron.py.

First, make sure to update validator.env with your wallet, hotkey, and validator port. This file was created for you during setup, and is not tracked by git.

# Subtensor Network Configuration:
NETUID=34                                      # Network User ID options: 34, 168
SUBTENSOR_NETWORK=finney                       # Networks: finney, test, local
SUBTENSOR_CHAIN_ENDPOINT=wss://entrypoint-finney.opentensor.ai:443
                                                # Endpoints:
                                                # - wss://entrypoint-finney.opentensor.ai:443
                                                # - wss://test.finney.opentensor.ai:443/

# Wallet Configuration:
WALLET_NAME=default
WALLET_HOTKEY=default

# Validator Port Setting:
VALIDATOR_AXON_PORT=8092

# API Keys:
WANDB_API_KEY=your_wandb_api_key_here
HUGGING_FACE_TOKEN=your_hugging_face_token_here

Then, log into weights and biases by running

wandb login

and entering your API key. If you don't have an API key, please reach out to the BitMind team via Discord and we can provide one.

Now you're ready to run your validator!

conda activate bitmind
pm2 start run_neuron.py -- --validator
  • Auto updates are enabled by default. To disable, run with --no-auto-updates.
  • Self-healing restarts are enabled by default (every 6 hours). To disable, run with --no-self-heal.