Skip to content

Latest commit

 

History

History
113 lines (82 loc) · 5.8 KB

Validating.md

File metadata and controls

113 lines (82 loc) · 5.8 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_env.sh 
./setup_env.sh

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.

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

# Note: If you're using RunPod, you must select a port >= 70000 for symmetric mapping
# Validator Port Setting:
VALIDATOR_AXON_PORT=8092
VALIDATOR_PROXY_PORT=10913
DEVICE=cuda

# API Keys:
WANDB_API_KEY=your_wandb_api_key_here
HUGGING_FACE_TOKEN=your_hugging_face_token_here

If you don't have a W&B 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.

The above command will kick off 4 pm2 processes

┌────┬───────────────────────────┬─────────────┬─────────┬─────────┬──────────┬────────┬──────┬───────────┬──────────┬──────────┬──────────┬──────────┐
│ id │ name                      │ namespace   │ version │ mode    │ pid      │ uptime │ ↺    │ status    │ cpu      │ mem      │ user     │ watching │
├────┼───────────────────────────┼─────────────┼─────────┼─────────┼──────────┼────────┼──────┼───────────┼──────────┼──────────┼──────────┼──────────┤
│ 2  │ bitmind_cache_updater     │ default     │ N/A     │ fork    │ 1601308  │ 2h     │ 0    │ online    │ 0%       │ 843.6mb  │ user     │ disabled │
│ 3  │ bitmind_data_generator    │ default     │ N/A     │ fork    │ 1601426  │ 2h     │ 0    │ online    │ 0%       │ 11.3gb   │ user     │ disabled │
│ 1  │ bitmind_validator         │ default     │ N/A     │ fork    │ 1601246  │ 2h     │ 0    │ online    │ 0%       │ 867.8mb  │ user     │ disabled │
│ 0  │ run_neuron                │ default     │ N/A     │ fork    │ 223218   │ 41h    │ 0    │ online    │ 0%       │ 8.9mb    │ user     │ disabled │
└────┴───────────────────────────┴─────────────┴─────────┴─────────┴──────────┴────────┴──────┴───────────┴──────────┴──────────┴──────────┴──────────┘
  • run_neuron manages self heals and auto updates
  • bitmind_validator is the validator process, whose hotkey, port, etc. are configured in validator.env
  • bitmind_data_generator runs our data generation pipeline to produce synthetic images and videos (stored in ~/.cache/sn34/synthetic)
  • bitmind_cache_updater manages the cache of real images and videos (stored in ~/.cache/sn34/real)