Bittensor Documentation — Bittensor Docs

ABOUT

WHITEPAPER

DOCS

DISCORD

WALLET

EXPLORE

⌘K<br>⌘K<br>Bittensor Documentation<br>Do anything on the Bittensor chain with the Bittensor SDK and CLI.<br>Copy MarkdownView as Markdown<br>Bittensor is an open network where independent subnets produce digital<br>commodities — compute, inference, storage, prediction — and the chain pays<br>participants in its token, TAO , in proportion to the value they contribute.<br>Miners produce the commodity, validators score the miners, subnet<br>creators define the incentive mechanism, and stakers back validators with<br>TAO.

These docs cover the bittensor Python SDK and CLI: one install gives you a<br>library (import bittensor) and a command line (btcli) that together can<br>perform every user-facing operation on the chain.

Coming from the v10 SDK or the standalone bittensor-cli? The API changed<br>substantially in v11 — see Migrating from v9/v10 for exact<br>old-to-new mappings.

Where to go

Quickstart<br>Install, connect, first query, first transaction — in five minutes.<br>For agents<br>How an agent discovers, previews, and safely executes any chain operation.<br>Transactions<br>Every state-changing operation, one page each, generated from the SDK.<br>Queries<br>Every chain read, one page each, generated from the SDK.<br>Errors<br>Every failure carries a machine-readable code and a remediation hint.<br>Concepts<br>The network, wallets, money, the client, and the transaction model.<br>Migrating from v9/v10<br>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<br>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.