Bittensor Documentation

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

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. See For agents → Searching these docs for the curl/grep recipes.

• /llms.txt — curated index; every docs link in it is already raw markdown (content.md).
• /llms-full.txt — entire docs corpus in one file (for rg, not for stuffing into context).
• Every page as raw markdown: /llms.mdx/docs/<slug>/content.md (also linked from each page’s copy-markdown control).
• /catalog/intents.json — every transaction with its JSON schema, signer, markdown_url, and summary.
• /catalog/reads.json — every query with parameters, markdown_url, and docs.
• /catalog/errors.json — semantic codes under .codes, chain names under .chain_errors; each has remediation + markdown_url.
• Chain Rust source: /code/search.json?q=… to search, /code/index.json to list, /code/raw/<repo-path> to fetch.
• The same catalogs, live from the tool itself: btcli tools on the CLI, bt.intents.list_tools() in Python.