Gittensor

Appearance

Miners ​

  • Contribute code to recognized open source repositories
  • Receive incentive for successfully merged PRs
  • No server required — miners just need a GitHub account and a Bittensor wallet

1. Create a Bittensor Wallet ​

Please refer to the official Bittensor documentation for creating or importing a Bittensor wallet (coldkey & hotkey).

2. Register to the Subnet ​

bash
# testnet
btcli subnet register --netuid 422 \
--wallet-name WALLET_NAME \
--hotkey WALLET_HOTKEY \
--network test

# mainnet
btcli subnet register --netuid 74 \
--wallet-name WALLET_NAME \
--hotkey WALLET_HOTKEY

3. Create a GitHub Fine-Grained PAT ​

  1. In GitHub, go to Settings → Developer settings → Personal access tokens → Fine-grained tokens
  2. Click Generate new token
  3. Configure:
    • Token name: gittensor
    • Expiration: No Expiration
    • Repository access: Public repositories (read-only)

TIP

Some GitHub organizations forbid fine-grained PATs with indefinite lifetime. If you are part of such an organization, either leave it or create a PAT with an expiration and rotate it periodically.

  1. Click Generate token and copy it

4. Install the CLI ​

bash
pip install uv
git clone [email protected]:entrius/gittensor.git
cd gittensor
uv venv && source .venv/bin/activate
uv pip install -e .

5. Broadcast Your PAT to Validators ​

bash
# mainnet (defaults to finney)
gitt miner post --pat <YOUR_PAT> --wallet <WALLET_NAME> --hotkey <HOTKEY_NAME> --netuid 74

# testnet
gitt miner post --pat <YOUR_PAT> --wallet <WALLET_NAME> --hotkey <HOTKEY_NAME> --netuid 422 --network test

If you omit --pat, the CLI will check the GITTENSOR_MINER_PAT environment variable, then prompt you interactively.

WARNING

Your GitHub identity is permanently pinned to your hotkey on first PAT broadcast. If you need to switch to a different GitHub account, you must deregister your UID and re-register with a new hotkey.

6. Verify Validators Received Your PAT ​

bash
# mainnet
gitt miner check --wallet <WALLET_NAME> --hotkey <HOTKEY_NAME> --netuid 74

# testnet
gitt miner check --wallet <WALLET_NAME> --hotkey <HOTKEY_NAME> --netuid 422 --network test

You should see a table showing which validators have your PAT stored and whether it's valid.

7. Start Contributing ​

  • See all recognized repositories at gittensor.io
  • Open PRs to recognized repositories
  • Scores are calculated when your PR is merged — no miner process needs to be running
  • The validator scoring round runs every 2 hours