Bittensor
Search…
πŸ₯•
Installation
Intelligence is the apex element

System requirements

Bittensor requires at least 4GB of RAM or 2 GB of RAM and 10 GB of swap space. Standard machine learning practice applies to Bittensor mining. We recommend a machine with a modern dual core CPU, at least 8GB of RAM, 100 GB of disk space, and a stable internet connection to take full advantage of Bittensor mining. We also do offer GPU support, but it is still experimental and will provide a small performance boost compared to a CPU.
Bittensor does not currently support TPU training, but will be implemented in the near future.
Currently, Bittensor only supports Linux and OS X support. Bittensor does not support Windows natively. To install using windows, please make use of windows subsystem for Linux (Installation).
Since mining at Bittensor is effectively training and offering up a machine learning model rather than solving complex hash equations, it is possible to run Bittensor on cloud computing services.

Installation

There are 2 ways for you to get access to Bittensor.

1. If you are a standard miner.

With python installed, run the following command.
1
python3 -m pip install bittensor
Copied!

2. If you are a developer that wants to customize your own deep learning model.

You can run the following install script that clones and installs the whole project.
1
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/opentensor/bittensor/master/scripts/install.sh)"
Copied!

Verify your installation

The installation includes 2 packages.

1. btcli

btcli handles most of the operations you may need for running your miner and managing your wallet. In the terminal, run
1
btcli --help
Copied!

2. bittensor

Bittensor is a python package, it handles all the connections to the chain. In a Python session, run
1
import bittensor
Copied!
That's it! You've set up the Bittensor miner to run on your computer.

Subtensor Installation

The Subtensor (an amalgamation of Substrate + Bittensor) blockchain runs standalone from the miners. You must have the Subtensor blockchain running before you can mine on Bittensor.
On each machine that runs miners, you must perform the following steps to run the substrate chain.
  1. 1.
    Install Docker by following the steps outlined here for your operating system. Once you have done so, follow the steps to install docker-compose .
  2. 2.
    First, clone the Subtensor repository to your local Bittensor folder:
    1
    git clone https://github.com/opentensor/subtensor.git ~/.bittensor/subtensor
    Copied!
  3. 3.
    Move into the directory first: cd ~/.bittensor/subtensor.
  4. 4.
    Run docker compose to pull the latest image of the blockchain and run it: docker-compose up
  5. 5.
    If the installation was successful, then you should see a massive output (these are debug logs, do not be alarmed it is not an error). Once synchronization finishes, you should see logs similar to this:
1
node-subtensor | 2021-11-23 18:42:22 ✨ Imported #147209 (0x83b6…4178)
2
node-subtensor | 2021-11-23 18:42:24 ✨ Imported #147210 (0x482f…be10)
3
node-subtensor | 2021-11-23 18:42:25 πŸ’€ Idle (28 peers), best: #147210 (0x482f…be10), finalized #147208 (0x50d1…e7f6), ⬇ 10.0kiB/s ⬆ 8.3kiB/s
4
node-subtensor | 2021-11-23 18:42:30 πŸ’€ Idle (28 peers), best: #147210 (0x482f…be10), finalized #147208 (0x50d1…e7f6), ⬇ 22.8kiB/s ⬆ 12.6kiB/s
Copied!
Now that the chain is running and synchronized, we can safely run it in the background and know our miners will always have a blockchain to connect to (local). Press ctrl + c to cancel the run, and then run it in the background:
1
docker-compose up -d
Copied!
​
​
Happy knowledge mining! πŸš€ 🧠
Last modified 6d ago