Bittensor CLI 安装使用指南

Bittensor CLI 安装使用指南

Bittensor CLI 是进入 Bittensor 网络的第一入口。无论是管理钱包、参与共识、还是调试子网，btcli 都提供了强大而灵活的工具集。
如果你正在搭建节点或开发子网，建议熟悉 btcli 的安装、配置和调试方法，它将是你探索 Bittensor 的核心利器。

面向互联网规模的神经网络

SDK • 钱包 • 白皮书

简介

Bittensor CLI（命令行工具）简称 btcli，是 Bittensor 平台的强大工具。
你可以在任何 macOS、Linux 或 WSL 终端上使用它来完成常见操作，例如：

  • 创建钱包
  • 注册子网或神经元
  • 委托 TAO
  • 查看议会提案并进行投票
  • 以及更多功能

每个命令都支持通过 --help 参数查看帮助信息。

btcli 截图

文档

安装步骤如下所述。完整文档请参考 Bittensor CLI 文档。

在 macOS 和 Linux 上安装

你可以通过源码、PyPI 或 Homebrew 安装 btcli。
安装完成后请务必验证。

对 macOS 用户的特别说明

macOS 自带的 Python (CPython) 使用 LibreSSL 编译，而不是 OpenSSL。
由于 btcli 使用的库对 LibreSSL 支持不完整，因此推荐：

  1. 使用 Homebrew 安装 Python；
  2. Rust FFI 绑定（若使用预编译轮子）也需要通过 Homebrew 安装 OpenSSL。

若使用系统自带 Python，可能会遇到兼容性问题。

从 PyPI 安装

1
pip install -U bittensor-cli

或者使用 uv：

1
uv pip install bittensor-cli

从 Homebrew 安装

1
brew install btcli

从源码安装

  1. 创建并激活虚拟环境：
1
2
python3 -m venv btcli_venv
source btcli_venv/bin/activate
  1. 克隆仓库：
1
git clone https://github.com/opentensor/btcli.git
  1. 进入目录：
1
cd btcli
  1. 安装：
1
pip3 install .

同时安装 Bittensor SDK

如果你希望同时安装 CLI 和 Bittensor SDK，可以直接执行：

1
pip install -U bittensor[cli]

在 Windows 上安装

要在 Windows 上运行 Bittensor SDK，必须安装 WSL 2，并选择 Ubuntu 发行版。

然后参考上文 在 macOS 和 Linux 上安装 的步骤。

⚠️ 注意：Windows 的支持有限

  • 钱包操作（委托、转账、注册、质押）可以在 WSL 2 上使用
  • 子网挖矿和验证操作不推荐在 Windows 上进行，并且不受支持

验证安装

1
btcli --version

该命令会显示你安装的 btcli 版本号。

配置

你可以在配置文件 config.yml 中设置常用参数，例如：

  • 热/冷钱包名称
  • 默认链 URL
  • 网络名称
  • 其他个性化配置

你也可以在执行 btcli 命令时通过参数覆盖这些值。

配置文件示例

默认配置文件位置：~/.bittensor/config.yml

示例：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
network: local
use_cache: true
dashboard_path: null
disk_cache: false
rate_tolerance: null
safe_staking: true
wallet_hotkey: default
wallet_name: coldkey-user1
wallet_path: ~/.bittensor/wallets
metagraph_cols:
  ACTIVE: true
  AXON: true
  COLDKEY: true
  CONSENSUS: true
  DIVIDENDS: true
  EMISSION: true
  HOTKEY: true
  INCENTIVE: true
  RANK: true
  STAKE: true
  TRUST: true
  UID: true
  UPDATED: true
  VAL: true
  VTRUST: true

更多帮助：

1
btcli config --help

环境变量

btcli 支持以下环境变量：

  • USE_TORCH (默认 0)：设为 1 时使用 PyTorch 替代 Numpy
  • DISK_CACHE (默认 0)：设为 1（或在配置中启用），使用磁盘缓存，提高部分查询效率
  • BTCLI_CONFIG_PATH (默认 ~/.bittensor/config.yml)：配置文件路径
  • BTCLI_DEBUG_FILE (默认 ~/.bittensor/debug.txt)：保存最新命令的调试日志

调试

  • 每次运行命令都会生成调试日志，默认位置：~/.bittensor/debug.txt
  • 可通过环境变量 BTCLI_DEBUG_FILE 自定义位置
  • 日志 不会包含私钥等敏感信息，可用于反馈问题

如果遇到问题：

1
btcli --debug

然后保存调试文件并联系开发者。推荐在 Discord 或 GitHub Issue 提交，并附上调试日志。