Vast internal guide to test subnets inside the Opentensor image

This tutorial shows how to use the Bittensor testnet to create a subnet and run your incentive mechanism on it.

1. Install Bittensor subnet template

cd into your project directory and clone the bittensor-subnet-template repo:

Bash

git clone https://github.com/opentensor/bittensor-subnet-template.git

Next, cd into bittensor-subnet-template repo directory:

Bash

cd bittensor-subnet-template # Enter the

Install the bittensor-subnet-template package:

Bash

python -m pip install -e .

2. Create wallets

Create wallets for subnet owner, subnet validator and for subnet miner. Follow all of these steps:

Bash

btcli wallet new_coldkey --wallet.name owner

Create a coldkey and hotkey for your miner wallet:

Bash

btcli wallet new_coldkey --wallet.name miner

and

Bash

btcli wallet new_hotkey --wallet.name miner --wallet.hotkey default

Create a coldkey and hotkey for your validator wallet:

Bash

btcli wallet new_coldkey --wallet.name validator

and

Bash

btcli wallet new_hotkey --wallet.name validator --wallet.hotkey default

3. Get the price of subnet creation

Creating subnets on the testnet is competitive. The cost is determined by the rate at which new subnets are being registered onto the chain.

Bash

btcli subnet lock_cost --subtensor.network test

The above command will show:

Bash

>> Subnet lock cost: τ100.000000000

4 Go to the Bittensor discord channel and ask them for test Taos

Here is the link to the discord channel for Bittensor.

4.5 Transfer test Taos to your miner wallet

Use the following command to list all your wallets:

Text

    btcli w list

You will get an output like this:

Text

    Wallets
    ├── 
    │   owner (5FyRdpzddeN7KGLhn6S6ia1up7dzbtXiZ5trc2hmm9AN9Pj4)
    ├── 
    │   miner (5GCahkVacWRHzVgRBfSmnt11gHnWWZhkapquzPEwR7je1a8w)
    │   └── default (5CUgZBi3GQpJDhe1EhdPJfzBb6pyWvnkuSWJ6SBhEpSby1XP)
    └── 
        validator (5FZSLAZsiFaZzhcL2oxMesSrQQHmWHSGpPfNjMUmiruBpYGB)
        └── default (5EqaFbjHDUQCHRbG5592QvCbpNkvAxsLCLKRNoLaVLN76g55)

Then transfer 0.001 Taos to your miner and validator wallet.

Transfer to miner wallet

Text

    btcli wallet transfer --dest 5GCahkVacWRHzVgRBfSmnt11gHnWWZhkapquzPEwR7je1a8w --wallet.name owner --amount 0.001 --subtensor.network test

Make sure the —dest key is the same as your wallet key that you get from the btcli w list command.

Transfer to validator wallet

Repeat this step for the validator wallet as well.

Text

    btcli wallet transfer --dest 5FZSLAZsiFaZzhcL2oxMesSrQQHmWHSGpPfNjMUmiruBpYGB --wallet.name owner --amount 0.001 --subtensor.network test

6. Register keys

This step registers your subnet validator and subnet miner keys to the subnet, giving them the first two slots on the subnet. Register your miner key to the subnet:

Bash

btcli subnet register --netuid 15 --subtensor.network test --wallet.name miner --wallet.hotkey default

Follow the below prompts:

Bash

>> Enter netuid [1] (1): # Enter netuid 1 to specify the subnet you just created.
>> Continue Registration?
  hotkey:     ...
  coldkey:    ...
  network:    finney [y/n]: # Select yes (y)
>> ✅ Registered

Next, register your validator key to the subnet:

Bash

btcli subnet recycle_register --netuid 15 --subtensor.network test --wallet.name validator --wallet.hotkey default

Follow the prompts:

Bash

>> Enter netuid [1] (1): # Enter netuid 1 to specify the subnet you just created.
>> Continue Registration?
  hotkey:     ...
  coldkey:    ...
  network:    finney [y/n]: # Select yes (y)
>> ✅ Registered

7. Check that your keys have been registered

This step returns information about your registered keys. Check that your miner has been registered:

Bash

btcli wallet overview --wallet.name miner --subtensor.network test

The above command will display the below:

Bash

Subnet: 1                                                                                                                                                                
COLDKEY  HOTKEY   UID  ACTIVE  STAKE(τ)     RANK    TRUST  CONSENSUS  INCENTIVE  DIVIDENDS  EMISSION(ρ)   VTRUST  VPERMIT  UPDATED  AXON  HOTKEY_SS58                    
miner    default  1      True   0.00000  0.00000  0.00000    0.00000    0.00000    0.00000            0  0.00000                14  none  5GTFrsEQfvTsh3WjiEVFeKzFTc2xcf…
1        1        2            τ0.00000  0.00000  0.00000    0.00000    0.00000    0.00000           ρ0  0.00000                                                         
                                                                          Wallet balance: τ0.0   

8. Run subnet miner and subnet validator

Run the subnet miner:

Bash

python neurons/miner.py --netuid 15 --subtensor.network test --wallet.name miner --wallet.hotkey default --logging.debug

You will see the below terminal output:

Bash

2024-01-22 17:34:42.694 |       INFO       | Miner running...              1705944882.6945262
2024-01-22 17:34:47.700 |       INFO       | Miner running...              1705944887.7002594
2024-01-22 17:34:52.706 |       INFO       | Miner running...              1705944892.7061048
2024-01-22 17:34:57.712 |       INFO       | Miner running...              1705944897.7120056

AI/ML frameworks

Serving infrastructure

Migration guides

AI agents

MCP

Text generation

Image generation

Video generation

Audio & transcription

Information extraction

Serverless deployments

Templates

Virtual desktops & VMs

Graphics & GPU programming

Other

Mining on Bittensor

Vast internal guide to test subnets inside the Opentensor image

1. Install Bittensor subnet template

2. Create wallets

3. Get the price of subnet creation

4 Go to the Bittensor discord channel and ask them for test Taos

4.5 Transfer test Taos to your miner wallet

Transfer to miner wallet

Transfer to validator wallet

6. Register keys

7. Check that your keys have been registered

8. Run subnet miner and subnet validator

​Vast internal guide to test subnets inside the Opentensor image

​1. Install Bittensor subnet template

​2. Create wallets

​3. Get the price of subnet creation

​4 Go to the Bittensor discord channel and ask them for test Taos

​4.5 Transfer test Taos to your miner wallet

​Transfer to miner wallet

​Transfer to validator wallet

​6. Register keys

​7. Check that your keys have been registered

​8. Run subnet miner and subnet validator

Vast internal guide to test subnets inside the Opentensor image

1. Install Bittensor subnet template

2. Create wallets

3. Get the price of subnet creation

4 Go to the Bittensor discord channel and ask them for test Taos

4.5 Transfer test Taos to your miner wallet

Transfer to miner wallet

Transfer to validator wallet

6. Register keys

7. Check that your keys have been registered

8. Run subnet miner and subnet validator