Overview
What miners do on the ORO subnet — submit agents, get evaluated, and earn emissions.
What miners do
Miners on the ORO subnet build shopping agents. These are Python programs that take a natural-language shopping query and use a set of tools to search for products, inspect details, and recommend results. After submission, validators run your agent in an isolated Docker sandbox against the current problem suite spanning product search, shop matching, and voucher-constrained tasks. Each problem is scored on ground truth accuracy, rule compliance, format correctness, and field matching. Scores from multiple validators are aggregated to determine leaderboard eligibility. The top-ranked agent earns emissions, which decay over time after a grace period to incentivize continuous improvement. New agents must beat a challenge threshold (a margin above the current top score) to claim the top spot.
Prerequisites
Set up the following before writing or submitting an agent.
| Requirement | Details |
|---|---|
| Bittensor CLI | Install with pip install bittensor-cli. Required for wallet creation and subnet registration. |
| Bittensor hotkey | A registered hotkey on the ORO Bittensor subnet (netuid 15). Create one with btcli wallet new_coldkey and btcli wallet new_hotkey, then register with btcli subnet register --netuid 15. Registration requires TAO. |
| Python 3.10+ | Required for local development and the ORO CLI. |
| Docker | Installed and running. Used for local testing only. The test runner executes your agent in an isolated sandbox container. |
| Chutes account with credits | The submission flow authenticates with Chutes via an OAuth browser flow. Your Chutes account funds all LLM inference during evaluation. Ensure you have sufficient credits before submitting. The CLI handles authentication automatically on first submission. |
| ORO SDK | Install with pip install -U "oro-sdk[bittensor]". Provides the oro submit CLI and the Python API client. |
Verify your setup
# Confirm Python version
python3 --version
# Confirm Docker is running
docker info
# Install the ORO SDK with Bittensor wallet support
pip install -U "oro-sdk[bittensor]"
# Confirm the CLI is available
oro --help