Skip to content
This repository was archived by the owner on Dec 5, 2023. It is now read-only.
Open
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
49 changes: 46 additions & 3 deletions validating/validating.md
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand All @@ -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
Expand All @@ -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
Expand Down