# Bittensor CLI

The Bittensor command line interface (CLI) allows programmatic access to the Bittensor ecosystem.

_Source: https://beta.taostats.io/docs/concepts/command-line-tool_

_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.

```
git clone https://github.com/opentensor/btcli.git
cd btcli
pip install .
```

### From pip

```
pip install bittensor-cli
```

If you would like the SDK and the CLI:

```
pip install bittensor[cli] #for sdk + cli
```

Trouble?  The most up-to-date instructions can be found in the [Bittensor documentation](https://beta.taostats.io/docs/concepts/command-line-tool).

## 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](https://github.com/opentensor/btcli). 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.