Miner setup

How to run a miner on the Leoma subnet: upload your fine-tuned Text-Image to Video (TI2V) model to Hugging Face, commit on-chain, and monitor your status.

1. Upload your model to Hugging Face

• Fine-tune or adapt a TI2V model, then upload it to Hugging Face as a model repository.

• Model naming (required): The repository name must start with leoma and end with your miner hotkey (SS58 address). Example: your_username/leoma-5F3sa2TJAWMqDhxG6jhV4N8ko9SxwGy8TpaNS1repo5DvT9 or your_username/leoma-v1-5F3sa2TJAWMqDhxG6jhV4N8ko9SxwGy8TpaNS1repo5DvT9.

• Revision (required): You must use a specific revision — the full Git commit SHA of the model version you deploy (e.g. a1b2c3d4e5f6...). Do not use branch names like main; miner validation expect an immutable commit.

---

2. Deploy to Chutes and commit on-chain

1. Deploy to Chutes (so validators can call your model):

   leoma miner push --model-name <your-hf-repo> --model-revision <full-commit-sha> --chutes-api-key <api-key> --chute-user <chutes-username>

   Use the full commit SHA as --model-revision (e.g. a1b2c3d4e5f6789...). This creates a Chute for your model. Note the Chute ID from the output.

2. Commit on-chain (register model + Chute for validators):

   leoma miner commit --model-name <your-hf-repo> --model-revision <full-commit-sha> --chute-id <chute-id> --coldkey <wallet-name> --hotkey <ss58-address>

   Use the same model_name and specific revision (commit SHA) as in step 1. Your wallet (coldkey/hotkey) must be registered on the subnet.

Commit payload on-chain is: model_name, model_revision, chute_id. Miner validation will check that the Hugging Face repo exists and the Chute is responsive.

---

3. Monitor your miner setup

• Network page (app): View leaderboard, valid miners, and recent evaluations. Confirm your hotkey appears and is valid.

• CLI: From the terminal you can fetch the current rank list (same data as the dashboard):

  leoma get-rank

  This calls the Leoma API and prints each miner’s rank, hotkey, passed count, pass rate, and eligibility. Use it to see where you stand without opening the app.

• API:

  • GET /miners/list — all miners; check is_valid and invalid_reason for your hotkey.

  • GET /miners/uid/{uid} or GET /miners/{hotkey} — your miner details.

  • GET /scores/rank — rank list; eligible is true when completeness ≥ 80%.

• If you are invalid, fix the issue (e.g. repo name format, Chute down, or blacklist) and wait for the next validation cycle.

---

Requirements summary

• Model: TI2V, on Hugging Face; repo name starts with leoma and ends with your hotkey.

• Revision: A specific revision (full Git commit SHA) is required — not a branch like main. Use the same commit SHA for leoma miner push and leoma miner commit.

• Chutes: Deploy via leoma miner push; validators call this endpoint.

• Wallet: Bittensor wallet (coldkey/hotkey) registered on the Leoma subnet.

• Eligibility: Completeness (completed tasks in the scoring window) ≥ 80% to be eligible for ranking and weight setting.

Next

• Validator setup — how validators run and set weights

• API reference — /miners, /scores/rank