Skip to main content
SUBMIT AN ISSUElast edit: Feb 21, 2024

Bittensor Developer Documentation

See what's new

Welcome! Bittensor is a protocol for decentralized subnets. Subnets exist to produce decentralized intelligence. Each subnet is an incentive-based competitive market in action, to produce the best decentralized intelligence. For example, the text prompting subnet incentivizes subnet miners who produce the best prompt completions in response to the prompts sent by the subnet validators in that subnet.

Subnets run on blockchain and constitute the core of the Bittensor ecosystem. The rewards for subnet participants are in the form of TAO tokens.

no need to create a subnet

A straightforward way to participate in the Bittensor network is to be a miner or a validator in an existing subnet. Follow the below links in the Validate or mine section. Alternately, if you want to create your own custom incentive mechanism, then you can create your own subnet and launch your own competition. See the below Running a subnet section.

Bittensor provides all the open source tools, the codebase and the documentation, with step-by-step tutorials and guides, to enable you to participate in the Bittensor ecosystem.


Start here

If you are new to Bittensor, start by learning the concepts. Then install the Bittensor software and create a wallet. Follow the below links.

Learn the concepts
Start by learning the Bittensor concept, building blocks and incentive mechanism.
READ MORE
Install
To validate or mine, or run your own subnet, install Bittensor and create wallet to get started.
READ MORE

Next, follow the below paths:


Validate or mine

You can participate in an existing subnet as either a subnet validator or a subnet miner. Follow the below links.

1. Checklist for validating and mining
When you are preparing to be a subnet validator or a subnet miner, use this checklist to get ready.
READ MORE
2. Register, validate and mine
Follow these steps to register and become a miner, or stake your TAO and become a validator.
READ MORE
3. Emissions
Learn how dividends for the validators and incentives for the miners are calculated.
READ MORE
4. Staking and Delegation
Get to know how staking and delegating your TAO works in the Bittensor network.
READ MORE
Governance
Learn how the Bittensor governance works as it transitions into full community-ownership over time.
READ MORE
Senate
Understand what Senate is, requirements to participate in a Senate and how voting works.
READ MORE

Running a subnet

Ready to run your own subnet? Follow the below links.

Basic subnet tutorials
Learn how to run a simple subnet locally or on testchain or mainchain.
READ MORE
Create a subnet
Step-by-step instructions for creating a local subnet or a subnet on testchain or mainchain.
READ MORE
OCR subnet tutorial
Shows how to convert your Python notebook containing validated code for an incentive mechanism into a working subnet.
READ MORE
Subnet hyperparameters
Get to know subnet hyperparameters and how to use them effectively. As a subnet owner, your success depends on this knowledge.
READ MORE

Bittensor CLI and API

Use the Bittensor CLI and Python API to develop and participate in the Bittensor network.

Bittensor CLI
With Bittensor CLI, you can stake or unstake funds, check network state and much more.
READ MORE
Python API
A comprehensive Python API reference documentation for the open-sourced Bittensor API.
READ MORE