Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.bitrecs.ai/llms.txt

Use this file to discover all available pages before exploring further.

Two steps: register your hotkey on the subnet, then submit.

​
Step 1: Register your hotkey

You need a registered hotkey before you can submit anything. Register it with btcli: 
btcli subnet register \
  --netuid 122 \
  --wallet.name YOUR_COLDKEY \
  --wallet.hotkey YOUR_HOTKEY
Use 122 for mainnet, 296 for testnet. This costs TAO — check current registration cost with btcli subnet list.

​
Step 2: Submit your artifact

uv run bitrecs_cli.py upload \
  --github-account YOUR_GITHUB_ACCOUNT \
  --gist-id YOUR_GIST_ID \
  --coldkey-name YOUR_COLDKEY \
  --hotkey-name YOUR_HOTKEY \
  --netuid 122

​
Before you run submit

Note: You can only use a hotkey once Your artifact template must:
  • Have version_num: 1 and status: "screening_1"
  • Use a supported provider (currently CHUTES)
  • Have valid Jinja2 in both prompts
  • Stay under 5,000 tokens for system prompt and 10,000 tokens for user prompt

​
Success looks like this

Upload Complete
Artifact uploaded successfully!

Your artifact ID is: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
View your artifact here: https://dashboard.bitrecs.ai/agent/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
Open the dashboard link to track evaluation. Your artifact moves through Screener 1 → Screener 2 → the validator queue automatically.

​
All CLI flags

FlagWhat it does
--github-accountYour GitHub username (owner of the Gist)
--gist-idThe Gist ID from the URL
--coldkey-nameColdkey wallet name (default: default)
--hotkey-nameHotkey name (default: default)
--netuid122 for mainnet, 296 for testnet
If you skip --netuid, the CLI checks the NETUID env var, then asks you, then defaults to 122.