Bittensor Documentation
Do anything on the Bittensor chain with the Bittensor SDK and CLI.
Bittensor is an open network where independent subnets produce digital commodities — compute, inference, storage, prediction — and the chain pays participants in its token, TAO, in proportion to the value they contribute. Miners produce the commodity, validators score the miners, subnet creators define the incentive mechanism, and stakers back validators with TAO.
These docs cover the bittensor Python SDK and CLI: one install gives you a
library (import bittensor) and a command line (btcli) that together can
perform every user-facing operation on the chain.
Where to go
Quickstart
Install, connect, first query, first transaction — in five minutes.
For agents
How an agent discovers, previews, and safely executes any chain operation.
Transactions
Every state-changing operation, one page each, generated from the SDK.
Queries
Every chain read, one page each, generated from the SDK.
Errors
Every failure carries a machine-readable code and a remediation hint.
Concepts
The network, wallets, money, the client, and the transaction model.
Migrating from v9/v10
Exact mappings from the legacy SDK and btcli to the unified v11 package.
Install
Requires Python 3.10–3.13. Using uv:
uv venv && source .venv/bin/activate
uv pip install bittensorThis installs both the btcli command and the bittensor Python package.
Machine-readable everything
If you are an agent (or building one), you never need to scrape these pages:
/llms.txt— index of every page;/llms-full.txt— the entire docs in one file.- Every page is fetchable as raw markdown: append
content.mdunder/llms.mdx/docs/...(linked from each page). /catalog/intents.json— every transaction with its JSON schema, signer, and summary./catalog/reads.json— every query with parameters and docs./catalog/errors.json— every error code with remediation, and the full chain-error classification.- The same catalogs, live from the tool itself:
btcli toolson the CLI,sub.intents.list_tools()in Python.