# jstrieb/github-stats

Better GitHub statistics images for your profile, with stats from private repos too

Repository: https://github.com/jstrieb/github-stats
Canonical: https://ross.abutalabs.com/products/github-stats
Language: Zig
License: GPL-3.0
License Family: copyleft
Topics: github-stats, statistics, profile, visualizations, github, github-api, github-actions, git-scraping, statistics-images, stats-images, readme-template, readme-md, zig, ziglang
Last push: 2026-08-26T01:48:09+00:00

## Health v2 (maintenance only)
Score: 93/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 99, release rhythm 81, longevity 100
- inputs: {"age_days": 2212, "days_push": 8, "days_rel": 130, "gap_med": 2.5, "n_releases_24m": 3}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 3542, forks 796 (observed 2026-08-28T04:08:09.228327+00:00)

## What it is
A tool that generates GitHub profile and repository statistics visualizations as SVG images using GitHub Actions, including data from private repositories. It runs entirely on GitHub Actions with no server required and outputs light/dark theme-aware images plus a JSON data dump.

## Use cases
- generate stats images for my GitHub profile README
- show contribution stats including private repos
- create GitHub statistics visualizations automatically
- track my GitHub activity with scheduled GitHub Actions
- export my GitHub stats as JSON for analysis
- make profile stats that switch between light and dark mode

## When to choose
- you want GitHub stats images that include private repository contributions
- you prefer a self-hosted, serverless setup running on GitHub Actions
- you want light/dark theme-aware SVGs for your profile README
- you want raw stats data in JSON for further analysis

## When to avoid
- you need real-time stats rather than periodically regenerated images
- you don't want to grant a GitHub token access to private repositories
- you need highly accurate line counts, since GitHub's API and git-based fallbacks have known inaccuracies
- you want a hosted service with zero setup

## Facets
- artifact type: application
- maturity: active
- function: data-visualization, analytics, web-scraping, ci-cd
- domain: developer-tools, data-visualization, version-control
- platform: cli
- tags: github-profile, github-actions, stats-images, readme, private-repos, zig, github

## Member repositories
- jstrieb/github-stats (main) score 93

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:08:09.228327+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T18:34:28.815105+00:00, confidence not recorded.
  - readme: https://github.com/jstrieb/github-stats (fetched 2026-08-28T04:08:09.228327+00:00, sha c726664cfbaf)
- Data as of 2026-08-30T08:39:29.467469+00:00.