{"id":48567703,"url":"https://github.com/compscidr/github-readme-stats","last_synced_at":"2026-04-08T13:32:24.814Z","repository":{"id":345620181,"uuid":"1186666489","full_name":"compscidr/github-readme-stats","owner":"compscidr","description":"GitHub profile stats cards with private repo support. Combines GraphQL live cards (Vercel) with daily REST Actions for accurate language breakdowns, streaks, and overview stats across public and private repos.","archived":false,"fork":false,"pushed_at":"2026-03-20T06:23:16.000Z","size":6662,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2026-03-20T13:46:13.317Z","etag":null,"topics":["contribution-streak","github-actions","github-api","github-profile","github-readme-stats","graphql","javascript","stats","svg","vercel"],"latest_commit_sha":null,"homepage":"https://github.com/compscidr/github-readme-stats","language":"JavaScript","has_issues":false,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/compscidr.png","metadata":{"files":{"readme":"readme.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null},"funding":{"github":["anuraghazra"],"patreon":null,"open_collective":null,"ko_fi":null,"tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"otechie":null,"custom":["https://www.paypal.me/anuraghazra","https://www.buymeacoffee.com/anuraghazra"]}},"created_at":"2026-03-19T21:39:42.000Z","updated_at":"2026-03-20T06:23:22.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/compscidr/github-readme-stats","commit_stats":null,"previous_names":["compscidr/github-readme-stats"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/compscidr/github-readme-stats","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/compscidr%2Fgithub-readme-stats","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/compscidr%2Fgithub-readme-stats/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/compscidr%2Fgithub-readme-stats/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/compscidr%2Fgithub-readme-stats/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/compscidr","download_url":"https://codeload.github.com/compscidr/github-readme-stats/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/compscidr%2Fgithub-readme-stats/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31558382,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-08T10:21:54.569Z","status":"ssl_error","status_checked_at":"2026-04-08T10:21:38.171Z","response_time":54,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["contribution-streak","github-actions","github-api","github-profile","github-readme-stats","graphql","javascript","stats","svg","vercel"],"created_at":"2026-04-08T13:32:24.704Z","updated_at":"2026-04-08T13:32:24.791Z","avatar_url":"https://github.com/compscidr.png","language":"JavaScript","readme":"# GitHub Readme Stats (Fork)\nIf you have 100+ repos including private ones, the existing solutions are either slow or incomplete. This fork fixes both.\n\nA fork of [anuraghazra/github-readme-stats](https://github.com/anuraghazra/github-readme-stats) that combines the best of three projects:\n\n- **[anuraghazra/github-readme-stats](https://github.com/anuraghazra/github-readme-stats)** — Fast GraphQL-based stats cards, but can't access private repo language data.\n- **[jstrieb/github-stats](https://github.com/jstrieb/github-stats)** — REST-based GitHub Actions that can access private repos, but hammers the API with sequential per-repo requests, causing rate limiting and unpredictable run times.\n- **[DenverCoder1/github-readme-streak-stats](https://github.com/DenverCoder1/github-readme-streak-stats)** — Contribution streak cards via an external service.\n\nThis fork uses **GraphQL for live stats cards** (served via Vercel) and **REST only where GraphQL falls short** (via a daily GitHub Action) for accurate language breakdowns across public and private repos. Streak stats are calculated directly from GitHub's contribution calendar — no external service needed.\n\n\u003cimg src=\"https://github-readme-stats-navy-three-39.vercel.app/api/combined/?username=compscidr\u0026theme=dark\u0026lang_count=10\" /\u003e\n\n## Endpoints\n\nThis fork adds the following endpoints on top of the [original ones](https://github.com/anuraghazra/github-readme-stats):\n\n| Endpoint | Description |\n|----------|-------------|\n| `/api/combined` | All-in-one card: stats + streaks + top languages |\n| `/api/overview` | Stars, forks, contributions, lines changed, views, repos |\n| `/api/streak` | Current and longest contribution streaks with dates |\n| `/api/top-langs?debug=true` | JSON debug output with per-repo language breakdown |\n\nAll original endpoints (`/api`, `/api/top-langs`, `/api/pin`, `/api/gist`, `/api/wakatime`) still work. See the [upstream docs](https://github.com/anuraghazra/github-readme-stats) for their full options.\n\n## Setup\n\n### 1. Fork and deploy to Vercel\n\nFork this repo and deploy to [Vercel](https://vercel.com). Add these environment variables:\n\n| Variable | Type | Required | Description |\n|----------|------|----------|-------------|\n| `PAT_1` | Secret | Yes | GitHub PAT with `repo` scope |\n| `GIST_ID` | Plain | Yes | ID of a public gist (see step 2) |\n| `FETCH_MULTI_PAGE_STARS` | Plain | Yes | Set to `true` |\n| `WHITELIST` | Plain | Recommended | Your GitHub username (prevents others using your instance) |\n\n### 2. Create a public gist\n\nCreate a **public** gist with a file called `github-stats.json`:\n\n```json\n{ \"linesChanged\": 0, \"repoViews\": 0, \"updatedAt\": \"\" }\n```\n\nThe gist ID is the hash in the URL. The GitHub Action populates this daily with stats that are too expensive to compute on each request.\n\n### 3. Configure GitHub Actions\n\nIn your fork's repo settings, add:\n\n| Name | Where | Description |\n|------|-------|-------------|\n| `GH_TOKEN` | Secret | GitHub PAT with `repo` + `gist` scopes |\n| `GIST_ID` | Variable | Same gist ID as above |\n| `USERNAME` | Variable | Your GitHub username |\n\nThe **Update GitHub Stats Cache** workflow runs daily at 5 AM UTC and computes lines of code changed, repository views, stars, forks, contributions, and repo count — then writes them to the gist. It also runs automatically when the script or workflow file changes.\n\n### 4. Trigger the first run\n\nGo to Actions \u003e Update GitHub Stats Cache \u003e Run workflow. After it completes, your cards will have data.\n\n## Usage\n\nReplace `YOUR_VERCEL_URL` with your Vercel deployment URL.\n\n### Combined card\n\n```md\n![Stats](https://YOUR_VERCEL_URL/api/combined?username=YOUR_USERNAME\u0026theme=dark)\n```\n\n### Individual cards\n\n```html\n\u003cimg height=\"180\" src=\"https://YOUR_VERCEL_URL/api/streak?username=YOUR_USERNAME\u0026theme=dark\" /\u003e\n\u003cimg height=\"180\" src=\"https://YOUR_VERCEL_URL/api/overview?username=YOUR_USERNAME\u0026theme=dark\" /\u003e\n\u003cimg height=\"180\" src=\"https://YOUR_VERCEL_URL/api/top-langs/?username=YOUR_USERNAME\u0026theme=dark\u0026layout=compact\u0026langs_count=10\u0026hide=html\" /\u003e\n```\n\nAll cards support theming — see the [upstream theme list](https://github.com/anuraghazra/github-readme-stats/blob/master/themes/README.md).\n\n## Architecture\n\n```\nVercel (live, on request)\n  ├── /api/overview      GraphQL: stars, forks, contributions, repos\n  ├── /api/streak        GraphQL: contribution calendar → streaks\n  ├── /api/top-langs     GraphQL: language data with pagination\n  └── /api/combined      Gist (cached stats) + live streak + live langs\n\nGitHub Action (daily)\n  ├── REST: /repos/{repo}/stats/contributors → lines changed\n  ├── REST: /repos/{repo}/traffic/views → repo views\n  ├── GraphQL: stars, forks, contributions, repos\n  └── Writes results to public gist\n```\n\n## Caching\n\nVercel caches card responses to avoid hitting GitHub's API on every request:\n\n| Card | Default | Min | Max |\n|------|---------|-----|-----|\n| Stats / Overview / Streak / Combined | 24 hours | 12 hours | 48 hours |\n| Top Languages | 6 days | 2 days | 10 days |\n\nYou can override the default with `\u0026cache_seconds=N` in the URL, but it will be clamped to the min/max range.\n\nAfter the daily GitHub Action updates the gist, it can take up to 24 hours for the combined card to reflect new data due to Vercel's edge cache. Adding a cache-busting parameter (e.g. `\u0026v=2`) will force a fresh render.\n\n## Debugging\n\nThe GitHub Action logs progress per-repo during the daily run, making it easy to identify which repos are slow or hitting API errors. You can also use the debug endpoint:\n\n```\n/api/top-langs?debug=true\u0026username=YOUR_USERNAME\n```\n\nThis returns JSON with the total repo count, repos after filtering, and a per-repo language breakdown — useful for tuning your `EXCLUDE_REPO` list or figuring out why your language stats look off.\n\n## License\n\n[MIT](./LICENSE) — Based on work by [Anurag Hazra](https://github.com/anuraghazra), [Jacob Strieb](https://github.com/jstrieb), and [Jonah Lawrence](https://github.com/DenverCoder1).\n","funding_links":["https://github.com/sponsors/anuraghazra","https://www.paypal.me/anuraghazra","https://www.buymeacoffee.com/anuraghazra"],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcompscidr%2Fgithub-readme-stats","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcompscidr%2Fgithub-readme-stats","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcompscidr%2Fgithub-readme-stats/lists"}