Skip to content

Latest commit

 

History

History
91 lines (71 loc) · 4.5 KB

running_a_validator.md

File metadata and controls

91 lines (71 loc) · 4.5 KB

Bittensor Validator Setup Guide

This document provides detailed instructions for setting up and running a Bittensor node using the Desearch repository. It is applicable for various networks including finney, local, and other custom endpoints using --subtensor.chain_endpoint <ENDPOINT>. Follow these steps to prepare your environment, install necessary packages, and start the Bittensor process.

We recommend using pm2 for process management. For installation, see the pm2 installation guide.

0. Install Conda Environment

Create and activate a new conda environment named val with Python 3.10:

conda create -n val python=3.10
conda activate val

1. Clone the Desearch repository and install dependencies

Clone and install the Desearch repository in editable mode:

git clone https://github.com/Datura-ai/desearch.git
cddDesearch
python -m pip install -r requirements.txt
python -m pip install -e .

3. Set up Your Wallet

Create new cold and hot keys:

btcli wallet new_coldkey
btcli wallet new_hotkey

4. Register your UID on the Network

Register your UID on the desired network:

btcli subnets register --subtensor.network test

5. Environment Variables Configuration

Please ensure that all required environment variables are set prior to running the validator. For a comprehensive list and setup guide, refer to the Environment Variables Guide.

6. Start the Process

Launch the process with pm2. Modify the command as needed:

pm2 start neurons/validators/api.py --interpreter /usr/bin/python3  --name validator_api -- 
    --wallet.name <your-wallet-name>  
    --netuid 22 
    --wallet.hotkey <your-wallet-hot-key>  
    --subtensor.network <network>

Example Command

pm2 start neurons/validators/api.py --interpreter /usr/bin/python3  --name validator_api -- --wallet.name validator --netuid 41 --wallet.hotkey default --subtensor.network testnet

Variable Explanation

  • --wallet.name: Provide the name of your wallet.
  • --wallet.hotkey: Enter your wallet's hotkey.
  • --netuid: Use 41 for testnet.
  • --subtensor.network: Specify the network you want to use (finney, test, local, etc).
  • --logging.debug: Adjust the logging level according to your preference.
  • --axon.port: Specify the port number you want to use.
  • --neuron.name: Trials for this miner go in miner.root / (wallet_cold - wallet_hot) / miner.name.
  • --neuron.device: Device to run the validator on. cuda or cpu
  • --neuron.disable_log_rewards: Disable all reward logging, suppresses reward functions and their values from being logged to wandb. Default: False
  • --neuron.moving_average_alpha: Moving average alpha parameter, how much to add of the new observation. Default: 0.05
  • --neuron.run_random_miner_syn_qs_interval: Sets the interval, in seconds, for querying a random subset of miners with synthetic questions. Set to a positive value to enable. A value of 0 disables this feature.
  • --neuron.run_all_miner_syn_qs_interval: Sets the interval, in seconds, for querying all miners with synthetic questions. Set to a positive value to enable. A value of 0 disables this feature.
  • --reward.summary_relevance_weight: adjusts the influence of a scoring model that evaluates the accuracy and relevance of a node's responses to given prompts.
  • --reward.twitter_content_weight: Specifies the weight for the reward model that evaluates the relevance and quality of summary text in conjunction with linked content data.
  • --neuron.only_allowed_miners: A list of miner identifiers, hotkey
  • --neuron.disable_twitter_completion_links_fetch: Enables the option to skip fetching content data for Twitter links, relying solely on the data provided by miners
  • --neuron.update_weight_interval:Defines the frequency (in seconds) at which the network's weight parameters are updated. The default interval is 2700 seconds (45 minutes).
  • --neuron.update_available_uids_interval: Specifies the interval, in seconds, for updating the list of available UIDs. The default interval is 600 seconds (10 minutes).

7. Monitor Your Process

Monitor the status and logs:

pm2 status
pm2 logs 0

Conclusion

Following these steps, you should have a Bittensor node running smoothly using the desearch repository. Regularly monitor your process and consult the Bittensor documentation for further assistance.

Note: Ensure at least >50GB free disk space for wandb logs.