Documentation / Bittensor concepts
Bittensor CLI
Last reviewed 2026-09-15
The Bittensor command line interface (CLI) allows programmatic access to the Bittensor ecosystem. As of September 2024, the BTCLI has is no longer part of the Bittensor package and is a standalone app.
Installation
From Source
As of release 8.0.0 (September 2024), the btcli has its own repository separate from the SDK.
text
git clone https://github.com/opentensor/btcli.git
cd btcli
pip install .From pip
text
pip install bittensor-cliIf you would like the SDK and the CLI:
text
pip install bittensor[cli] #for sdk + cliTrouble? The most up-to-date instructions can be found in the Bittensor documentation.
Using the CLI
To get all of the latest commands from the CLI use btcli --help
The command: btcli --commands shows a simple tree of possible commands
The authoritative help is always what your installed version prints — run btcli --help locally, or see the Bittensor CLI repository. A sample of the top-level help output looks like this:
shell
btcli --help
Command line interface (CLI) for Bittensor. Uses the values in the configuration file. These values can be overridden by passing them explicitly in the command line.
╭─ Options ─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╮
│ --version Show BTCLI version │
│ --commands Show BTCLI commands │
│ --install-completion Install completion for the current shell. │
│ --show-completion Show completion for the current shell, to copy it or customize the installation. │
│ --help Show this message and exit. │
╰───────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯
╭─ Commands ────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╮
│ config Config commands, aliases: `c`, `conf` │
│ stake Stake commands, alias: `st` │
│ subnets Subnets commands, alias: `s`, `subnet` │
│ sudo Sudo commands, alias: `su` │
│ wallet Wallet commands, aliases: `wallets`, `w` │
╰───────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯
Made with ❤ by The Openτensor Foundaτion Configuring the CLI
The new btcli config allows you to set default parameters on your installation.