Bittensor Documentation

⌘K

Bittensor Documentation

Do anything on the Bittensor chain with the Bittensor SDK and CLI.

Copy MarkdownView as Markdown

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

QuickstartInstall, connect, first query, first transaction — in five minutes.For agentsHow an agent discovers, previews, and safely executes any chain operation.TransactionsEvery state-changing operation, one page each, generated from the SDK.QueriesEvery chain read, one page each, generated from the SDK.ErrorsEvery failure carries a machine-readable code and a remediation hint.ConceptsThe network, wallets, money, the client, and the transaction model.Migrating from v9/v10Exact 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 bittensor

This 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.md` under `/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 tools` on the CLI, `sub.intents.list_tools()` in Python.