Gittensor Hub

A dashboard for miners on Bittensor Subnet 74 (SN74) — the subnet that rewards merged GitHub PRs in whitelisted open-source repos.

It polls GitHub for issues and PRs across the 200+ SN74 repos (plus any you add), caches them in SQLite, and surfaces them in Dashboard, Explorer, Miners, Repositories, Issues, and Pull Requests views.

Built with Next.js 15 (App Router), TypeScript, Primer React, and better-sqlite3.

Main views

• / redirects to /dashboard, the daily SN74 overview.
• /dashboard shows network activity, scored PRs, issue discovery, reward-ranked Top Contributions, and PR/issue pipelines.
• /explorer is the repo drill-down view for issues and pull requests.
• /miners, /repositories, /issues, and /pulls provide focused global tables.

Dashboard reward-share cards follow the Gittensor allocator at UI level:

• Repo slice = emission_share * 90%.
• Active maintainer_cut is removed only when registered maintainer miners exist.
• The remaining slice is split by issue_discovery_share.
• Empty PR/issue sub-pools spill within the same repo.

Quick start

git clone https://github.com/MkDev11/gittensor-hub.git
cd gittensor-hub
pnpm install
cp .env.local.example .env.local   # then fill in the values (see below)
pnpm dev                           # http://localhost:12074

Requires Node 20+ and pnpm.

Development checks

pnpm run lint
pnpm run lint:warnings
pnpm exec tsc --noEmit --incremental false
pnpm build

pnpm run lint is warning-free and matches the CI lint gate. Use pnpm run lint:warnings when you want the full ESLint report locally.

GitHub setup

You need an OAuth App (sign-in) and one or more Personal Access Tokens (polling).

OAuth App — https://github.com/settings/developers → New OAuth App

• Homepage URL: http://localhost:12074 (or your public URL in prod)
• Callback URL: <homepage>/api/auth/github/callback
• Copy the client ID + secret into .env.local.

PATs — https://github.com/settings/tokens

• Scopes: public_repo, read:user.
• Create 2–4 tokens and paste them comma-separated into GITHUB_PATS — the poller rotates between them to spread the rate limit.

Access

Anyone with a GitHub account can sign in — there is no admin-approval gate. Admins (configured via ADMIN_GITHUB_LOGINS) can revoke access by marking a user rejected from the admin users page, which signs them out and blocks future sign-ins.

Environment variables

Var	Purpose
GITHUB_USERNAME	Your GitHub login (default miner identity)
GITHUB_PATS	Comma-separated PATs, rotated automatically
GITHUB_OAUTH_CLIENT_ID / GITHUB_OAUTH_CLIENT_SECRET	OAuth app credentials
ADMIN_GITHUB_LOGINS	Comma-separated logins auto-granted admin on first sign-in
SESSION_SECRET	Optional; auto-generated on first run if omitted, or set to a 32+ character secret
PORT	HTTP port (default 12074)

Production

pnpm build
pm2 start ecosystem.config.js
pm2 save                  # survive reboot
pm2 logs gittensor-hub

The app serves plain HTTP. Put nginx/Caddy in front for TLS — auth cookies switch to Secure automatically via x-forwarded-proto.

License

MIT