Gittensor

<p align="center">
  <a href="https://gittensor.io/">
    <img src="assets/gt-logo.jpg" alt="Gittensor Logo" width="800" />
  </a>
</p>

# Gittensor

Incentivize open source contributions.

[![Website](https://img.shields.io/badge/Website-gittensor.io-blue)](https://gittensor.io)
[![Discord](https://img.shields.io/badge/Discord-Join-5865F2?logo=discord&logoColor=white)](https://discord.com/invite/bittensor)
[![Twitter](https://img.shields.io/twitter/follow/gittensor_io?style=social)](https://x.com/gittensor_io)

## Introduction

[Gittensor](https://gittensor.io/) is a [Bittensor subnet](https://docs.learnbittensor.org/subnets/understanding-subnets) (SN74) that accelerates open source software development by rewarding meaningful contributions. Miners earn TAO by making real, merged pull requests to recognized open source repositories.

## How it Works

Miners register with a fine-grained [GitHub personal access token](https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/managing-your-personal-access-tokens) (PAT) and contribute to whitelisted open source repositories. When their pull requests get merged, validators authenticate account ownership via the PAT, verify the merged contributions, and score them based on code quality, repository allocation, and programming language factors. Rewards are distributed within each repository's configured emission share.

## Why Gittensor

Open source powers the modern world, yet most contributors work for free. Gittensor solves this by creating a decentralized marketplace where:

- **Real work gets rewarded** — Only merged PRs to legitimate repositories earn emissions
- **Quality over quantity** — Semantic code analysis evaluates actual contribution value
- **Sybil-resistant** — GitHub account verification and merge requirements prevent gaming

The result: a sustainable incentive layer that channels resources toward building and maintaining the software we all depend on.

---

## Miners

No miner neuron required — just register your GitHub PAT with validators using the CLI.

```bash
# Install
git clone https://github.com/entrius/gittensor.git
cd gittensor
uv sync

# Set your GitHub PAT
export GITTENSOR_MINER_PAT=ghp_your_token_here

# Broadcast PAT to validators
gitt miner post --wallet <name> --hotkey <hotkey>

# Check which validators have your PAT stored
gitt miner check --wallet <name> --hotkey <hotkey>
```

See full guide **[here](https://docs.gittensor.io/miner.html)**

### Compute miners (serving)

Gittensor also pays verified GPU time: an RTX 5090 running the blessed inference release earns **$0.70 per
verified GPU-hour** (paid in alpha, inside a 5% emission cap). Validators verify the traffic they route to you
against their own reference GPU — there is no separate audit prompt set — so a new miner sits in *probation*
until its rolling window passes, then goes READY. One card = one payout; extra hotkeys on the same card share it.

No clone, no build — every image is published on Docker Hub:

```bash
# 1. The whole box (runtime + attest + neuron) from one compose file. Fill .env from the
#    "Current release" card on gittensor.io/compute (images + the model pin) plus wallet/network/port.
curl -O https://raw.githubusercontent.com/entrius/gittensor/main/docker-compose.miner.yml
curl -o .env https://raw.githubusercontent.com/entrius/gittensor/main/miner.env.example
nano .env
docker compose -f docker-compose.miner.yml up -d

# 2. Prove the box is conformant before you serve (model id from the same card)
docker run --rm --network host entrius/gt-checker \
  --base-url http://127.0.0.1:8080 --model-id qwen3.8-27b --attest-url http://127.0.0.1:8081
```

Your status (READY / probation / quarantined, window, throughput, estimated payout, last miss reason) is on
[gittensor.io/compute](https://gittensor.io/compute). See full guide **[here](https://docs.gittensor.io/compute-miner.html)**

## Validators

**Recommended: Deploy with Docker and Docker Watchtower for automatic updates**

```bash
# Quick start
git clone https://github.com/entrius/gittensor.git
cd gittensor
cp .env.example .env
# Edit .env with proper values
nano .env

docker-compose -f docker-compose.vali.yml up -d
```

See full guide **[here](https://docs.gittensor.io/validator.html)**

**Serving (compute):** to pay compute miners a validator needs its own RTX 5090 running the reference runtime —
`SERVING_ENABLED=true` plus the `reference` compose profile:

```bash
# the release's artifact pins, from serving_loadout.json: a GGUF (SPARKINFER_MODEL_SHA256) or a pinned Hugging Face
# model directory (SPARKINFER_MODEL_DIR_REPO / _REVISION / _SHA256) — docker-compose.vali.yml lists every variable
SPARKINFER_TAG=<runtime_pin> SPARKINFER_MODEL_DIR_REPO=<model_dir.repo> SPARKINFER_MODEL_DIR_REVISION=<model_dir.revision> \
  SPARKINFER_MODEL_DIR_SHA256=<model_dir.sha256> docker compose -f docker-compose.vali.yml --profile reference up -d
```

Without a reference the validator still validates OSS and sends the serving cap to UID 0. All `SERVING_*`
variables are documented in `.env.example`; set `STORE_DB_RESULTS=true` to also publish serving rounds for
[gittensor.io/compute](https://gittensor.io/compute).

## Reward Algorithm

### Important Structures

- Master Repositories & Emission Shares

A list of repositories pulled from GitHub that have been deemed valid for scoring. They each have a configured emission share that bounds how much of the scoring pool the repository can receive in a round.

_NOTE: this list will be dynamic. It will see various audits, additions, deletions, emission-share changes, and shuffles as the subnet matures._

_NOTE: don’t be afraid to provide recommendations for your favorite open source repositories and the team will review it as a possible addition. A repo is more likely to be included if: they provide contributing guidelines, are active/community driven, provide value/have users_

- Programming Language Weights

A list of major file types/exten