github-stats - github-stats

Summary

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

📖 Highlights

GitHub Stats Visualization generates visualizations of GitHub user and repository statistics using GitHub Actions, supporting private repos and contributions to repos you don't own. The images automatically switch between GitHub light and dark themes. It also dumps all statistics to a JSON file for further analysis.

Generates SVG statistics images via GitHub Actions.
Supports private repositories and contributed repos.
Auto-switches between light and dark GitHub themes.
Dumps raw data to JSON for custom analysis.
No external server required; runs on GitHub Actions.
Uses personal access token for API access.
Excludes specified repos and languages via secrets.

🚀 Install & Usage

1. Create a classic personal access token with read:user, user:email, and repo permissions.
2. [Generate a copy of this repository](https://github.com/jstrieb/github-stats/generate).
3. Add the token as a repository secret named ACCESS_TOKEN.
4. (Optional) Add secrets EXCLUDE_REPOS and EXCLUDE_LANGUAGES to exclude repos/languages.
5. Run the "Generate stats" workflow from the Actions tab.
6. Retrieve generated images from the generated branch.

🤖 AI Deep Analysis

A solid choice for users who need private repo stats and prefer a lightweight, automated solution, though it lacks the extensive features and community support of more popular alternatives.

✅ Pros

Generates stats images including private repos
Uses GitHub Actions for automation
Lightweight and fast (written in Zig)
Customizable via configuration
No external dependencies required

⚠️ Cons

Requires GitHub Actions setup
Limited to GitHub ecosystem
Less feature-rich than some alternatives
Documentation could be improved

🎯 Use cases

Displaying GitHub statistics on profile README
Tracking both public and private repository stats
Automated stats image generation via CI/CD
Showcasing coding activity in a visual format

⚖️ Comparison

Compared to similar tools like anuraghazra/github-readme-stats, this project offers private repo stats but has fewer customization options and themes. It is more performant due to Zig but less widely adopted.