diff --git a/validating/validating.md b/validating/validating.md index bda6836..583c588 100644 --- a/validating/validating.md +++ b/validating/validating.md @@ -24,7 +24,45 @@ btcli nominate btcli delegate --delegate_ss58key DELEGATE_SS58KEY ``` -### Running a Validator + +### Validating on Subnetwork 1 with OpenValidators + +If you plan to validate on the text prompting network, after attaining enough TAO for a [validator permit](validating/validator-permit) we recommend running Bittensor's [openvalidators](https://github.com/opentensor/validators). You can run and install openvalidators from [source:](https://github.com/opentensor/validators.git) + +```bash dark +$ git clone https://github.com/opentensor/validators.git +$ pip3 install -e openvalidators/ +$ tree validators + ├── README.md # Openvalidator instructions. + ├── requirements.txt # Openvalidator requirements. + ├── analysis/ # Analysis toolkit to facilitate exploration of data generated by openvalidators. + ├── openvalidators/ # The root folder for the openvalidators code. + ├── scripts/ # Data extraction toolkit to facilitate data collection from wandb + ├── setup.py # Openvalidator installation script + └── tests/ # Unit-tests for openvalidators code +``` + +or from `pip:` +```bash dark +pip3 install openvalidators +``` + +The **openvalidators** implementation is set by default to **subnetwork 1**, following our recommendation. + +### Running openvalidators with PM2 +It is recommended that you run validator using a process manager such as [PM2](https://pm2.io/). +```bash dark +sudo apt-get install npm +npm install pm2 +pm2 start validators/openvalidators/neuron.py + --name my_validator + --interpreter python3 + -- ... your args i.e. --wallet.name ... +``` + +> Note: Please be aware that the code for openvalidators is consistently being enhanced. Therefore, it is important to have the most up-to-date version when running it in order to optimize your incentives. We are currently working on an automated mechanism to fetch the latest version continuously, which will be released shortly. + +### Running a core Validator (for Subnetwork 3) After attaining enough TAO for a [validator permit](validating/validator-permit) we recommend running Bittensor's [core validator](https://github.com/opentensor/bittensor/tree/text_prompting/neurons/text/prompting/validators). You can run and install the core validator from [source](https://github.com/opentensor/bittensor.git). ```bash dark @@ -41,7 +79,12 @@ $ tree bittensor README.md # Core validator instructions. ... ``` -When running, specify the `--netuid 1` parameter to select the appropriate subnetwork for your validator, e.g. Subnetwork 1. + +> Note: +Even though you can run the core validator in subnet 1, **we strongly advise utilizing openvalidators for this purpose, as it offers enhanced incentives for you.** + +As of this moment, it's still possible to run the core validator in subnetwork 1. +When running the core validator, specify the `--netuid 1` parameter to select the appropriate subnetwork for your validator, e.g. Subnetwork 1. ```bash dark title=neurons/text_prompting/validators/core link=https://github.com/opentensor/bittensor/tree/text_prompting/neurons/text/prompting/validators/core python3 ~/.bittensor/bittensor/neurons/text_prompting/validators/core/neuron.py --netuid 1 @@ -50,7 +93,7 @@ python3 ~/.bittensor/bittensor/neurons/text_prompting/validators/core/neuron.py --logging.trace ``` -### Running with PM2 +### Running the core validator with PM2 It is recommended that you run validator using a process manager such as [PM2](https://pm2.io/). ```bash dark sudo apt-get install npm