This page documents the current subcommands implemented in minotaur_subnet/miner/main.py. Use it as a flag-by-flag reference once you’re past the Quickstart.

↳ BG · 00 Overview How mining works and the champion/challenger model. ↳ START · 01 Quickstart Get a miner running end-to-end. ↳ HELP · 05 Troubleshooting Common errors and fixes.

Available subcommands

Subcommand	Purpose
agent	LLM-driven strategy loop.
submit	Signed git-based solver submission.
status	Submission status polling.

agent

terminal SH COPY

python -m minotaur_subnet.miner.main agent \
[--validator-url <url>] \
[--strategy-dir <dir>] \
[--miner-id <id>] \
[--loop-interval <seconds>] \
[--improvement-threshold <float>] \
[--max-llm-calls <n>] \
[--stale-after <seconds>] \
[--model <name>] \
[--claude-timeout <seconds>] \
[--anvil-rpc-url <url>]

Defaults

Flag	Default
--validator-url	http://localhost:8080
--strategy-dir	strategies
--miner-id	miner-agent-001
--loop-interval	60.0
--improvement-threshold	0.7
--max-llm-calls	3
--stale-after	600.0
--model	sonnet
--claude-timeout	300.0
--anvil-rpc-url	(not set)

submit

terminal SH COPY

python -m minotaur_subnet.miner.main submit \
--repo-url <https-url> \
--commit-hash <hash> \
--hotkey <wallet-name> \
[--wallet-path <path>] \
[--validator-url <url>] \
[--epoch <n>] \
[--poll]

Defaults

Flag	Default
--validator-url	http://localhost:9100
--epoch	Auto-detect attempted via GET {validator_url}/v1/status
--wallet-path	~/.bittensor/wallets (or BT_WALLET_PATH)

i

Note

In local testnet / API flows, --validator-url is usually http://localhost:8080 for /v1/submissions*. If your target does not expose /v1/status, pass --epoch explicitly.

The signed request payload includes:

• repo_url, commit_hash, epoch
• hotkey (SS58)
• signature over {repo_url}:{commit_hash}:{epoch}

status

terminal SH COPY

python -m minotaur_subnet.miner.main status \
--submission-id <id> \
[--validator-url <url>]

Defaults

Flag	Default
--validator-url	http://localhost:9100
Internal timeout	30 seconds for this command path

Terminal states

Status	Meaning
scored	Benchmark complete — score recorded but did not exceed the dethrone margin.
adopted	Solver was hot-swapped in as the new champion.
rejected	Screening failed or invariant check tripped.

Environment variables

Variable	Description
BT_WALLET_PATH	Fallback wallet root for signed submissions.

Examples

Agent loop

terminal SH COPY

python -m minotaur_subnet.miner.main agent \
--validator-url http://localhost:8080 \
--strategy-dir ./strategies

Git submission

terminal SH COPY

python -m minotaur_subnet.miner.main submit \
--repo-url https://github.com/myuser/my-solver \
--commit-hash abc123def456 \
--hotkey my-hotkey \
--epoch 0 \
--validator-url http://localhost:8080 \
--poll

Status check

terminal SH COPY

python -m minotaur_subnet.miner.main status \
--submission-id sub_abc123 \
--validator-url http://localhost:8080

See also

↳ API · 03 Solver API IntentSolver and Strategy contracts. ↳ DEEP · 04 Custom Solver Implementation guidance.