Logo
RPC Assistant

How to Mine TAO on Bittensor: A Practical Guide for Developers

Summary

Mining TAO on Bittensor means running a miner on a subnet that produces a digital commodity—such as inference, compute, or storage—and getting rewarded in TAO. This guide explains the roles of miners, validators, and subnets, how to choose a subnet, and the practical steps to register and run a miner, including the RPC endpoints you'll need to interact with the Finney network.

Quick decision guide: Is mining TAO right for you?

Before you dive into hardware and registration, take a moment to decide whether mining TAO fits your goals and resources. Mining on Bittensor is not like traditional proof-of-work mining; it's a competitive machine-learning marketplace where you run a miner that provides a service to a subnet. Here's a quick checklist to help you decide:

  • Do you have ML expertise or a strong engineering background? Many subnets reward miners who can fine-tune models or optimize inference. Without some technical skill, you may struggle to compete.
  • Can you afford the hardware and operational costs? You'll need a GPU with sufficient VRAM, reliable power, and a stable internet connection. Renting cloud GPUs is an option but adds recurring costs.
  • Are you prepared for ongoing maintenance? Miners must stay online, update software, and monitor performance. Downtime can hurt your rewards.
  • Do you understand the subnet you're joining? Each subnet has its own incentive mechanism and competition level. Research before committing.

If you're not ready to run a miner yourself, consider staking TAO to validators instead—it's a lower-effort way to participate. If you do proceed, the rest of this guide walks you through the technical steps.

What is Bittensor and how does mining work?

Bittensor is a decentralized network where independent subnets produce digital commodities—compute, inference, storage, prediction—and the chain pays participants in TAO. The network has four key roles:

  • Miners produce the commodity (e.g., serve model inference requests).
  • Validators score miners based on the quality of their output.
  • Subnet creators define the incentive mechanism for their subnet.
  • Stakers back validators with TAO, earning a share of rewards.

Mining TAO means registering a hotkey on a subnet and running a miner that responds to requests from validators. Your rewards depend on how well your miner performs relative to others on the same subnet.

Choosing a subnet: where to mine

Not all subnets are equal. Some have high competition and high emission; others are newer with lower competition but also lower rewards. Here's how to evaluate:

  • Emission rate: Check the total TAO emitted to a subnet per day. Higher emission attracts more miners.
  • Competition: Look at the number of registered miners and their performance. A subnet with many strong miners is harder to break into.
  • Your skills: Match your expertise to the subnet's requirements. For example, if you're good at natural language processing, consider a text-based subnet.
  • Hardware requirements: Some subnets need high-end GPUs; others can run on CPU. Review the subnet's documentation.

You can browse subnets on Taostats or the Bittensor explorer. Start with a subnet that aligns with your hardware and skills, even if emission is lower—it's better to earn consistently than to burn resources on a hyper-competitive subnet.

Prerequisites: hardware, software, and wallet

Before you can mine, you need:

  • A Linux server (Ubuntu 20.04+ recommended) with a GPU. Minimum 8GB VRAM, but 24GB+ is common for many subnets.
  • Python 3.10–3.14 and pip.
  • Bittensor SDK (bittensor) and btcli.
  • A Bittensor wallet with a coldkey and hotkey. Your hotkey is what registers as a miner.
  • TAO for registration fees and transaction fees. Registration costs vary by subnet.

Install the SDK using uv or pip:

# Using uv (recommended)
uv venv
uv pip install bittensor

# Or with pip
pip install bittensor

After installation, verify with:

btcli --version

Connecting to the Finney network: RPC endpoints

To interact with the Bittensor chain, you need a connection to a Finney node. You can run your own node, but that requires syncing the blockchain and maintaining infrastructure. A simpler approach is to use a public RPC endpoint from a provider like OnFinality.

OnFinality offers a public endpoint for the Bittensor Finney mainnet:

  • HTTPS: https://bittensor-finney.api.onfinality.io/public
  • WebSocket: wss://bittensor-finney.api.onfinality.io/public-ws

These endpoints support both HTTP and WebSocket transports, so you can use them for querying chain state and submitting transactions. For production mining operations, you may want a dedicated node to avoid rate limits and ensure reliability—see OnFinality's dedicated node service.

Setting up your miner: step-by-step

1. Create a wallet

btcli wallet create --wallet-name my_wallet

This creates a coldkey and hotkey. Back up your coldkey securely—losing it means losing access to your funds.

2. Get TAO for registration

You'll need TAO in your coldkey to pay for registration and transaction fees. Transfer TAO from an exchange or another wallet to your coldkey address.

3. Register on a subnet

Choose a subnet and register your hotkey:

btcli subnet register --netuid <SUBNET_ID> --wallet-name my_wallet --hotkey my_hotkey

Replace <SUBNET_ID> with the actual netuid. Registration costs a fee in TAO, which varies by subnet.

4. Run the miner

Each subnet has its own miner code. Clone the subnet's repository and follow its instructions. Typically, you'll run a Python script that connects to the network and serves requests.

Example using the Bittensor SDK to connect to Finney:

import bittensor as bt

subtensor = bt.subtensor(network="finney")
wallet = bt.wallet(name="my_wallet", hotkey="my_hotkey")

# Check registration
if subtensor.is_hotkey_registered(wallet.hotkey.ss58_address, netuid=1):
    print("Hotkey registered on subnet 1")
else:
    print("Not registered")

5. Monitor and maintain

Once your miner is running, monitor its performance. Use the Bittensor dashboard or Taostats to see your miner's scores and rewards. Keep your software updated and ensure your miner stays online.

Common pitfalls and troubleshooting

  • Registration failures: Ensure you have enough TAO for the registration fee and that your hotkey is not already registered on that subnet.
  • Connection issues: If you can't connect to the chain, check your RPC endpoint. Public endpoints can be rate-limited; consider a dedicated node for production.
  • Low rewards: If your miner isn't earning, it may be underperforming. Review the subnet's scoring mechanism and adjust your model or hardware.
  • Hardware bottlenecks: Monitor GPU usage and memory. If your miner is slow, validators may score you lower.

Monitoring your miner: key signals

Track these metrics to ensure your miner is healthy:

MetricWhat to watchWhy it matters
Uptime99%+Downtime means missed requests and lower scores
Response timeLow latencyFaster responses score higher
Reward rateConsistentIndicates your miner is competitive
Registration statusActiveIf deregistered, you stop earning

Use the Bittensor SDK to query your miner's status:

# Get miner info
miner_info = subtensor.get_miner_info(wallet.hotkey.ss58_address, netuid=1)
print(miner_info)

Key Takeaways

  • Mining TAO is not proof-of-work; it's about providing valuable machine-learning services to a subnet.
  • Choose a subnet that matches your skills and hardware to maximize your chances of earning.
  • You need a Bittensor wallet, TAO for registration, and a reliable connection to the Finney network.
  • Use a public RPC endpoint like OnFinality's for quick setup, but consider a dedicated node for serious mining operations.
  • Monitor your miner's performance and stay updated with subnet changes.

Frequently Asked Questions

Can I mine TAO with a gaming PC?

Yes, some subnets have low hardware requirements and can run on a gaming PC with a decent GPU. However, competition is high, and you may earn less than the cost of electricity. Research the subnet's requirements first.

Do I need to know machine learning to mine?

Not necessarily, but it helps. Many subnets reward miners who can improve models or serve inference efficiently. Without ML skills, you may struggle to compete.

How much does it cost to register as a miner?

Registration fees vary by subnet and can change based on demand. You'll also need TAO for transaction fees. Check the current fees on the Bittensor explorer.

What is the best RPC provider for Bittensor?

OnFinality offers public and dedicated RPC endpoints for Bittensor Finney. For production mining, a dedicated node provides more reliability and lower latency. See RPC pricing for options.

Can I mine on a testnet first?

Bittensor has a test network, but mining on testnet doesn't earn real TAO. It's useful for testing your miner setup before registering on mainnet.

Next steps

Now that you understand the basics, here's what to do next:

  1. Set up a wallet and get some TAO.
  2. Choose a subnet that fits your hardware and skills.
  3. Register your miner and run the code.
  4. Monitor performance and iterate.

For reliable RPC access, explore OnFinality's Bittensor Finney page and consider a dedicated node if you're serious about mining. Check our supported networks for other chains you might want to interact with.

Happy mining!

RPC Knowledge Base

Related RPC details

Never Worry about Infrastructure Again

OnFinality takes away the heavy lifting of DevOps so you can build smarter and faster.

Get Started