内容摘录
<div align="center">
**Bittensor SDK** <!-- omit in toc -->
Discord Chat
CodeQL
PyPI version
Codecov
License: MIT
---
Internet-scale Neural Networks <!-- omit in toc -->
Discord • Network • Research • Documentation
</div>
Overview of Bittensor
The Bittensor SDK
Is Bittensor a blockchain or an AI platform?
Subnets
Subnet validators and subnet miners
Yuma Consensus
Release Notes
Install Bittensor SDK
Upgrade
Install on macOS and Linux
Install using a Bash command
Install using pip3 install
Install from source
Verify using Python interpreter
Verify by listing axon information
Release Guidelines
Contributions
License
Acknowledgments
---
Overview of Bittensor
Welcome! Bittensor is an open source platform on which you can produce competitive digital commodities. These digital commodities can be machine intelligence, storage space, compute power, protein folding, financial markets prediction, and many more. You are rewarded in **TAO** when you produce best digital commodities.
The Bittensor SDK
The Opentensor Foundation (OTF) provides all the open source tools, including this Bittensor SDK, the codebase and the documentation, with step-by-step tutorials and guides, to enable you to participate in the Bittensor ecosystem.
**Developer documentation**: https://docs.bittensor.com.
**A Beginner's Q and A on Bittensor**: https://docs.bittensor.com/questions-and-answers.
**Bittensor whitepaper**: https://bittensor.com/whitepaper.
This Bittensor SDK contains ready-to-use Python packages for interacting with the Bittensor ecosystem, writing subnet incentive mechanisms, subnet miners, subnet validators and querying the subtensor (the blockchain part of the Bittensor network).
---
Is Bittensor a blockchain or an AI platform?
In Bittensor there is one blockchain, and many platforms that are connected to this one blockchain. We call these platforms as **subnets**, and this one blockchain **subtensor**. So, a subnet can be AI-related or it can be something else. The Bittensor network has a number of distinct subnets. All these subnets interact with subtensor blockchain. If you are thinking, "So, subnets are not part of the blockchain but only interact with it?" then the answer is "yes, exactly."
Subnets
Each category of the digital commodity is produced in a distinct subnet. Applications are built on these specific subnets. End-users of these applications would be served by these applications.
Subnet validators and subnet miners
Subnets, which exist outside the blockchain and are connected to it, are off-chain competitions where only the best producers are rewarded. A subnet consists of off-chain **subnet validators** who initiate the competition for a specific digital commodity, and off-chain **subnet miners** who compete and respond by producing the best quality digital commodity.
Yuma Consensus
Scores are assigned to the top-performing subnet miners and subnet validators. The on-chain Yuma Consensus determines the TAO rewards for these top performers. The Bittensor blockchain, the subtensor, runs on decentralized validation nodes, just like any blockchain.
**This SDK repo is for Bittensor platform only**
This Bittensor SDK codebase is for the Bittensor platform only, designed to help developers create subnets and build tools on Bittensor. For subnets and applications, refer to subnet-specific websites, which are maintained by subnet owners.
Release Notes
See Bittensor SDK Release Notes.
---
Install Bittensor SDK
Before you can start developing, you must install Bittensor SDK and then create Bittensor wallet.
Upgrade
If you already installed Bittensor SDK, make sure you upgrade to the latest version. Run the below command:
---
Install on macOS and Linux
Note for macOS users
The macOS preinstalled CPython installation is compiled with LibreSSL instead of OpenSSL. There are a number
of issues with LibreSSL, and as such is not fully supported by the libraries used by bittensor. Thus we highly recommend, if
you are using a Mac, to first install Python from Homebrew. Additionally, the Rust FFI bindings
[if installing from precompiled wheels (default)] require the Homebrew-installed OpenSSL pacakge. If you choose to use
the preinstalled Python version from macOS, things may not work completely.
Installation
You can install Bittensor SDK on your local machine in either of the following ways. **Make sure you verify your installation after you install**:
Install using a Bash command.
Install using pip3 install
Install from source
Install using a Bash command
This is the most straightforward method. It is recommended for a beginner as it will pre-install requirements like Python, if they are not already present on your machine. Copy and paste the following bash command into your terminal:
**For Ubuntu-Linux users**
If you are using Ubuntu-Linux, the script will prompt for sudo access to install all required apt-get packages.
Install using pip3 install
Install from source
Create and activate a virtual environment
Create Python virtual environment. Follow this guide on python.org.
Activate the new environment. Follow this guide on python.org
Clone the Bittensor SDK repo
Install
You can install using any of the below options:
**Install SDK**: Run the below command to install Bittensor SDK in the above virtual environment. This will also install btcli.
**Install SDK with torch**: Install Bittensor SDK with torch.
In some environments the above command may fail, in which case run the command with added quotes as shown below:
**Install SDK with cubit**: Install Bittensor SDK with cubit.
Install cubit first. See the Install section. **Only Python 3.9 and 3.10 versions are supported**.
Then install SDK with pip install bittensor.
Troubleshooting
SSL: CERTIFICATE_VERIFY_FAILED
If you are encountering a [SSL: CERTIFICATE_VERIFY_FAILED] certificate verify failed: unable to get local issuer certificate
error, use the command python -m bittensor certifi which will update your local SSL certifi…