• Bittensor概述
• Bittensor SDK
• Bittensor是区块链还是AI平台？
• 子网
• 子网验证者和子网矿工
• Yuma共识
• 发布说明
• 安装Bittensor SDK
• 升级
• 在macOS和Linux上安装
  • 使用Bash命令安装
  • 使用pip3 install安装
  • 从源码安装
  • 使用Python解释器验证
  • 通过列出axon信息验证
• 发布指南
• 贡献
• 许可证
• 致谢

---

Bittensor概述

欢迎！Bittensor是一个开源平台，您可以在上面生产具有竞争力的数字商品。这些数字商品可以是机器智能、存储空间、计算能力、蛋白质折叠、金融市场预测等等。当您生产出最佳的数字商品时，您将获得TAO奖励。

Bittensor SDK

Opentensor基金会（OTF）提供了所有开源工具，包括这个Bittensor SDK、代码库和文档，以及循序渐进的教程和指南，以帮助您参与Bittensor生态系统。

• 开发者文档: https://docs.learnbittensor.org。
• Bittensor初学者问答: https://docs.learnbittensor.org/questions-and-answers。
• Bittensor白皮书: https://bittensor.com/whitepaper。

这个Bittensor SDK包含可直接使用的Python包，用于与Bittensor生态系统交互、编写子网激励机制、子网矿工、子网验证者，以及查询subtensor（Bittensor网络的区块链部分）。

---

Bittensor是区块链还是AI平台？

在Bittensor中，有一个区块链，以及许多连接到这个区块链的平台。我们称这些平台为子网，而这个区块链则称为subtensor。因此，子网可以是与AI相关的，也可以是其他领域。Bittensor网络拥有多个不同的子网。所有这些子网都与subtensor区块链进行交互。如果您在想：“那么，子网并不是区块链的一部分，只是与它交互吗？”答案是：“是的，正是如此。”

子网

每一种数字商品都在一个独立的子网上生产。应用程序构建在这些特定的子网上。这些应用程序的最终用户将受益于这些应用。

子网验证者和子网矿工

子网存在于区块链之外，但与之相连，它们是链下竞赛，只有最优秀的生产者才能获得奖励。一个子网由链下的子网验证者组成，他们发起针对特定数字商品的竞赛；以及链下的子网矿工，他们通过生产最高质量的数字商品来参与竞争并作出响应。

Yuma共识

得分会被分配给表现最佳的子网矿工和子网验证者。链上的Yuma共识会决定这些顶尖表现者的TAO奖励。Bittensor区块链，即subtensor，运行在去中心化的验证节点上，就像任何区块链一样。

此SDK仓库仅适用于Bittensor平台 此Bittensor SDK代码库仅适用于Bittensor平台，旨在帮助开发者创建子网并在Bittensor上构建工具。有关子网和应用程序的信息，请参考由子网所有者维护的子网专属网站。

发布说明

请参阅Bittensor SDK发布说明。

---

安装Bittensor SDK

在开始开发之前，您必须先安装Bittensor SDK，然后创建Bittensor钱包。

升级

如果您已经安装了Bittensor SDK，请确保升级到最新版本。运行以下命令：

python3 -m pip install --upgrade bittensor

---

在macOS和Linux上安装

macOS用户注意事项

macOS预装的CPython安装是使用LibreSSL而非OpenSSL编译的。LibreSSL存在诸多问题，因此不被Bittensor所使用的库完全支持。所以，我们强烈建议使用Mac的用户首先通过Homebrew安装Python。此外，Rust FFI绑定[如果从预编译的wheel包安装（默认）]需要Homebrew安装的OpenSSL包。如果您选择使用macOS自带的Python版本，可能会出现无法正常工作的情况。

安装方法

您可以通过以下任一方式在本地机器上安装Bittensor SDK。请务必在安装后验证您的安装：

• 使用Bash命令安装。
• 使用pip3 install安装。
• 从源码安装。

使用Bash命令安装

这是最简单的方法。对于初学者来说非常推荐，因为它会在您的机器上尚未安装Python等依赖项时自动为您安装。将以下bash命令复制并粘贴到您的终端中：

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/opentensor/bittensor/master/scripts/install.sh)"

适用于Ubuntu-Linux用户 如果您使用的是Ubuntu-Linux，脚本会提示您输入sudo权限以安装所有必需的apt-get软件包。

使用pip3 install安装

python3 -m venv bt_venv
source bt_venv/bin/activate
pip install bittensor

从源代码安装

1. 创建并激活虚拟环境

   • 创建 Python 虚拟环境。请按照 python.org 上的指南 操作。

   • 激活新创建的虚拟环境。请按照 python.org 上的指南 操作。

2. 克隆 Bittensor SDK 仓库

git clone https://github.com/opentensor/bittensor.git

3. 安装

您可以使用以下任一选项进行安装：

• 安装 SDK：运行以下命令以在上述虚拟环境中安装 Bittensor SDK。这也将安装 btcli。

  pip install bittensor
  

• 安装带 torch 的 SDK：安装带有 torch 的 Bittensor SDK。

   pip install bittensor[torch]
  

  在某些环境中，上述命令可能会失败，此时请使用带引号的命令，如下所示：

    pip install "bittensor[torch]"
  

• 安装带 cubit 的 SDK：安装带有 cubit 的 Bittensor SDK。

  1. 首先安装 cubit。请参阅 安装 部分。仅支持 Python 3.9 和 3.10 版本。
  2. 然后使用 pip install bittensor 安装 SDK。

故障排除

SSL: CERTIFICATE_VERIFY_FAILED

如果您遇到 [SSL: CERTIFICATE_VERIFY_FAILED] certificate verify failed: unable to get local issuer certificate 错误，请使用命令 python -m bittensor certifi 来更新本地 SSL 证书。

---

在 Windows 上安装

要在 Windows 上安装和运行 Bittensor SDK，您必须在 Windows 上安装 WSL 2（适用于 Linux 的 Windows 子系统），并选择 Ubuntu Linux 发行版。

完成上述安装后，请按照上面 在 macOS 和 Linux 上安装 中描述的相同步骤进行安装。

警告：Windows 上的支持有限 虽然可以使用 WSL 2 在 Windows 机器上执行诸如委托、转账、注册、质押等钱包交易，但挖矿和验证操作不建议在 Windows 机器上进行，并且不受支持。

---

验证安装

您可以通过以下任一方式验证安装：

使用 btsdk 版本验证

python3 -m bittensor

上述命令将显示您刚刚安装的 btsdk 版本。

使用 Python 解释器验证

1. 在终端中启动 Python 解释器。

   python3
   

2. 在 Python 解释器中输入以下两行：

   import bittensor as bt
   print( bt.__version__ )
   

   Python 解释器的输出将如下所示：

   Python 3.11.6 (main, Oct  2 2023, 13:45:54) [Clang 15.0.0 (clang-1500.0.40.1)] on darwin
   Type "help", "copyright", "credits" or "license" for more information.
   >>> import bittensor as bt
   >>> print( bt.__version__ )
   <版本号>
   

   您将看到您安装的版本号代替 <版本号>。

通过列出轴突信息验证

您还可以通过列出神经元的轴突信息来验证 Bittensor SDK 的安装。在 Python 解释器中输入以下内容：

import bittensor
metagraph = bittensor.Metagraph(1)
metagraph.axons[:10]

Python 解释器的输出将如下所示：

[AxonInfo( /ipv4/3.139.80.241:11055, 5GqDsK6SAPyQtG243hbaKTsoeumjQQLhUu8GyrXikPTmxjn7, 5D7u5BTqF3j1XHnizp9oR67GFRr8fBEFhbdnuVQEx91vpfB5, 600 ), AxonInfo( /ipv4/8.222.132.190:5108, 5CwqDkDt1uk2Bngvf8avrapUshGmiUvYZjYa7bfA9Gv9kn1i, 5HQ9eTDorvovKTxBc9RUD22FZHZzpy1KRfaxCnRsT9QhuvR6, 600 ), AxonInfo( /ipv4/34.90.71.181:8091, 5HEo565WAy4Dbq3Sv271SAi7syBSofyfhhwRNjFNSM2gP9M2, 5ChuGqW2cxc5AZJ29z6vyTkTncg75L9ovfp8QN8eB8niSD75, 601 ), AxonInfo( /ipv4/64.247.206.79:8091, 5HK5tp6t2S59DywmHRWPBVJeJ86T61KjurYqeooqj8sREpeN, 5E7W9QXNoW7se7B11vWRMKRCSWkkAu9EYotG5Ci2f9cqV8jn, 601 ), AxonInfo( /ipv4/51.91.30.166:40203, 5EXYcaCdnvnMZbozeknFWbj6aKXojfBi9jUpJYHea68j4q1a, 5CsxoeDvWsQFZJnDCyzxaNKgA8pBJGUJyE1DThH8xU25qUMg, 601 ), AxonInfo( /ipv4/149.137.225.62:8091, 5F4tQyWrhfGVcNhoqeiNsR6KjD4wMZ2kfhLj4oHYuyHbZAc3, 5Ccmf1dJKzGtXX7h17eN72MVMRsFwvYjPVmkXPUaapczECf6, 600 ), AxonInfo( /ipv4/38.147.83.11:8091, 5Hddm3iBFD2GLT5ik7LZnT3XJUnRnN8PoeCFgGQgawUVKNm8, 5DCQw11aUW7bozAKkB8tB5bHqAjiu4F6mVLZBdgJnk8dzUoV, 610 ), AxonInfo( /ipv4/38.147.83.30:41422, 5HNQURvmjjYhTSksi8Wfsw676b4owGwfLR2BFAQzG7H3HhYf, 5EZUTdAbXyLmrs3oiPvfCM19nG6oRs4X7zpgxG5oL1iK4MAh, 610 ), AxonInfo( /ipv4/54.227.25.215:10022, 5DxrZuW8kmkZPKGKp1RBVovaP5zHtPLDHYc5Yu82Z1fWqK5u, 5FhXUSmSZ2ec7ozRSA8Bg3ywmGwrjoLLzsXjNcwmZme2GcSC, 601 ), AxonInfo( /ipv4/52.8.243.76:40033, 5EnZN591jjsKKbt3yBtfGKWHxhxRH9cJonqTKRT5yTRUyNon, 5ChzhHyGmWwEdHjuvAxoUifHEZ6xpUjR67fDd4a42UrPysyB, 601 )]
>>>

测试

您可以在 IDE 的交互模式下或通过终端运行集成测试和单元测试，命令如下：

pytest tests/integration_tests
pytest tests/unit_tests

E2E 测试有两种启动方式（旧版运行器）：

• 使用基于 Substrait 代码的编译器；
• 使用已构建好的 Docker 镜像（Docker 运行器）。

本地环境变量：

• LOCALNET_SH_PATH - 克隆的 Subtensor 仓库中 localnet.sh 脚本的路径（用于旧版运行器）；
• BUILD_BINARY - （=0 或 =1）- 与 LOCALNET_SH_PATH 一起使用，决定是否在启动 Localnet 节点之前进行构建（用于旧版运行器）；
• USE_DOCKER - （=0 或 =1）- 如果您希望使用特定的运行器来执行 E2E 测试，则设置此变量（用于 Docker 运行器）；
• FAST_BLOCKS - （=0 或 =1）- 允许以快速区块模式或非快速区块模式运行 Localnet 节点（适用于两种类型的运行器）。
• SKIP_PULL - 当您使用 Docker 镜像时，如果出于某种原因需要暂时禁用从仓库更新镜像的逻辑，可以使用此变量。

使用 docker 运行器（目前默认）：

• 使用 Docker 镜像的 E2E 测试无需预先编译；
• 执行速度非常快；
• 需要在操作系统中安装 Docker。

使用方法：

pytest tests/e2e_tests

使用 legacy 运行器：

• 将开始编译您 Subtensor 仓库中的代码；
• 您必须在本地环境中提供 LOCALNET_SH_PATH 变量，并指定克隆的仓库中 /scripts/localnet.sh 文件的路径；
• 您可以使用 BUILD_BINARY=0 变量，这将跳过每次测试的复制步骤。
• 您可以使用 USE_DOCKER=0 变量，即使您的操作系统中已安装 Docker，也会使用“旧版运行器”来运行测试。

使用方法：

常规 E2E 测试运行：

LOCALNET_SH_PATH=/path/to/your/localnet.sh pytest tests/e2e_tests

如果您希望跳过每次 E2E 测试的重新构建过程：

BUILD_BINARY=0 LOCALNET_SH_PATH=/path/to/your/localnet.sh pytest tests/e2e_tests

如果您希望在已安装 Docker 的操作系统中仍使用旧版运行器：

USE_DOCKER=0 BUILD_BINARY=0 LOCALNET_SH_PATH=/path/to/your/localnet.sh pytest tests/e2e_tests

---

发布指南

发布经理的说明：请参阅 RELEASE_GUIDELINES.md 文档。

贡献

准备好贡献了吗？在提交拉取请求之前，请阅读 贡献指南。

许可证

MIT 许可证（MIT） 版权所有 © 2025 OpenTensor 基金会
版权所有 © 2025 Yuma Rao

特此授予任何人免费获取本软件及其相关文档文件（以下简称“软件”）的副本的权利，允许其在不受限制的情况下处理该软件，包括但不限于使用、复制、修改、合并、发布、分发、再许可和/或销售该软件的副本，并允许向任何获得该软件的人提供服务，但须遵守以下条件：

上述版权声明和本许可声明应包含在该软件的所有副本或实质性部分中。

本软件按“原样”提供，不提供任何形式的明示或暗示担保，包括但不限于适销性、特定用途适用性和非侵权性。在任何情况下，作者或版权所有者均不对因本软件或其使用而引起的任何索赔、损害或其他责任负责，无论这些责任是基于合同、侵权行为或其他原因产生的。

致谢

learning-at-home/hivemind

Bittensor SDK 快速上手指南

Bittensor 是一个去中心化的机器学习网络，允许开发者构建和竞争数字商品（如 AI 模型、存储、算力等），并通过 TAO 代币获得奖励。本指南将帮助中国开发者快速搭建开发环境并验证安装。

1. 环境准备

系统要求

• 操作系统：
  • 推荐：Linux (Ubuntu 20.04+) 或 macOS。
  • Windows：必须安装 WSL 2 (Windows Subsystem for Linux) 并选择 Ubuntu 发行版。注意：Windows 原生不支持挖矿和验证节点操作，仅适合钱包管理。
• Python 版本：Python 3.9 或 3.10（部分组件如 cubit 严格限制在此范围）。
• macOS 特别提示：
  • macOS 自带的 Python 使用 LibreSSL，可能导致兼容性问题。强烈建议通过 Homebrew 安装 Python 和 OpenSSL：

    brew install python openssl
    

前置依赖

确保已安装 git 和 pip3。建议使用虚拟环境以避免依赖冲突。

2. 安装步骤

你可以选择以下任一方式进行安装。国内用户若遇到网络延迟，可配置 pip 国内镜像源（如阿里云或清华源）。

方法一：一键脚本安装（推荐新手）

此方法会自动检测并安装缺失的依赖（如 Python）。

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/opentensor/bittensor/master/scripts/install.sh)"

Ubuntu 用户可能需要输入 sudo 密码以安装系统级依赖。

方法二：使用 pip 安装（标准方式）

建议先创建并激活虚拟环境：

# 创建虚拟环境
python3 -m venv bt_venv

# 激活环境 (Linux/macOS)
source bt_venv/bin/activate

# 激活环境 (Windows WSL)
# source bt_venv/bin/activate 

# 安装 Bittensor SDK (可选：添加国内镜像加速)
# pip install bittensor -i https://pypi.tuna.tsinghua.edu.cn/simple
pip install bittensor

可选扩展安装：

• 如需 PyTorch 支持：

  pip install "bittensor[torch]"
  

• 如需 Cubit 支持（仅限 Python 3.9/3.10，需先单独安装 cubit）：

  pip install bittensor
  

方法三：从源码安装

适用于需要修改源码或开发贡献者。

# 1. 克隆仓库
git clone https://github.com/opentensor/bittensor.git
cd bittensor

# 2. 确保已激活虚拟环境，然后安装
pip install .

故障排除：SSL 证书错误

若安装过程中出现 [SSL: CERTIFICATE_VERIFY_FAILED] 错误，请运行以下命令更新本地证书：

python -m bittensor certifi

3. 基本使用与验证

安装完成后，请通过以下方式验证环境是否就绪。

验证版本信息

在终端运行以下命令，若输出版本号则说明安装成功：

python3 -m bittensor

Python 交互式验证

启动 Python 解释器并执行以下代码，检查是否能正确导入库并获取网络节点信息：

import bittensor as bt

# 打印版本号
print(bt.__version__)

# 获取子网元数据并列出前 10 个 Axon 信息
metagraph = bt.Metagraph(1)
print(metagraph.axons[:10])

预期输出示例： 你将看到类似以下的列表，包含节点的 IP、热键、冷键等信息：

[AxonInfo( /ipv4/3.139.80.241:11055, 5GqDsK..., 5D7u5B..., 600 ), ...]

下一步

环境验证通过后，你可以：

1. 创建钱包：btcli wallet new_coldkey
2. 注册子网或成为验证者/矿工。
3. 访问官方文档 docs.learnbittensor.org 深入学习子网开发。