overview

Same envelope as the GitHub stats API, pointed at Forgejo / Gitea / Codeberg / any Gitea-compatible host. Source is tashifkhan/GitHost-Stats-API. Design notes: dump 038.

There is no githost-stats.tashif.codes hostname yet. Run it yourself. Default local port is 8008. Local playground. Sample /taf/profile?host=git.taf.sh.

CodeTrace does not call this today. The dashboard still talks to github-stats.tashif.codes for github.com.

• Overview
• Targeting a host
• Canonical endpoints
• Envelope and schemas
• Deep history
• Architecture
• Why not GitHub’s API
• SSRF and registry
• Request path

Summary, profile, language stats, heatmap, derived badges, repos, orgs. Envelope adds instance (registry key or hostname) and software ({name, version}). platform is "forgejo" or "gitea" from a live version probe, not a hardcoded string.

Requests without an explicit host are rejected. There is no implicit “first registry entry”.

cd GitHost
uv sync
cp .env.example .env
uv run uvicorn main:app --reload --port 8008

Default registry:

taf=https://git.taf.sh,codeberg=https://codeberg.org,gitea=https://gitea.com

Override with GITHOST_INSTANCES. Optional tokens and Redis live in .env.