Free Tool

GitHub README Stats Generator

A GitHub README stats generator is a free tool that builds live Markdown image cards for your GitHub profile or project README, including contribution stats, top languages, coding streaks, trophies, and pinned repositories.

Configure the cards below, preview them instantly, then copy one clean Markdown block into your README.md.

Configure your cards

Build copy-ready Markdown for the cards people already embed in GitHub profiles.

Cards

Options

Live README preview

These previews update with the same options used in the Markdown below.

No signup or token

GitHub stats

Activity overview
@octocat

Live contribution stats

Commits, PRs, reviews, and profile signal

https://github-readme-stats.vercel.app/api?username=octocat&show_icons=true&include_all_commits=true&count_private=false&theme=tokyonight&hide_border=true

Top languages

Language mix
@octocat

Compact layout

README-ready language breakdown card

https://github-readme-stats.vercel.app/api/top-langs/?username=octocat&layout=compact&theme=tokyonight&hide_border=true

Contribution streak

Daily momentum
@octocat

Current streak card

Shows consecutive public contribution days

https://streak-stats.demolab.com/?user=octocat&theme=tokyonight&hide_border=true

Pinned repo

octocat/Spoon-Knife
@octocat

Pinned repository

Highlights a project with stars, language, and fork count

https://github-readme-stats.vercel.app/api/pin/?username=octocat&repo=Spoon-Knife&show_owner=true&theme=tokyonight&hide_border=true

Copy-ready Markdown

Paste this into your GitHub profile README or project README.

## octocat's GitHub stats

![octocat's GitHub stats](https://github-readme-stats.vercel.app/api?username=octocat&show_icons=true&include_all_commits=true&count_private=false&theme=tokyonight&hide_border=true)

![octocat's top languages](https://github-readme-stats.vercel.app/api/top-langs/?username=octocat&layout=compact&theme=tokyonight&hide_border=true)

![octocat's GitHub streak](https://streak-stats.demolab.com/?user=octocat&theme=tokyonight&hide_border=true)

![octocat/Spoon-Knife repo card](https://github-readme-stats.vercel.app/api/pin/?username=octocat&repo=Spoon-Knife&show_owner=true&theme=tokyonight&hide_border=true)

---

[Built with the free GitHub README Stats Generator](https://www.codecard.dev/tools/github-readme-stats-generator) by Code Card.

Want a full developer stats profile?

Code Card turns Claude Code, Codex, and OpenClaw sessions into a public profile with activity graphs, token breakdowns, badges, and shareable cards. Start with npx code-card.

Get Code Card

FAQ

GitHub README stats questions

What is a GitHub README stats generator?

A GitHub README stats generator creates Markdown image embeds for live GitHub profile cards, including contribution stats, top languages, streaks, trophies, and pinned repositories.

How do I add GitHub stats to my README?

Enter your GitHub username, pick the cards and theme you want, copy the generated Markdown, and paste it into your README.md file. GitHub renders the image cards automatically.

Do the stats cards update automatically?

Yes. Most cards are generated by live image endpoints, so the images refresh as your public GitHub activity changes. You do not need to edit the Markdown each time.

Can private contributions appear in the stats?

Private contributions only appear when GitHub or the card service can access and display them. Public README embeds should be treated as public-facing profile content.

Is this GitHub README stats generator free?

Yes. The generator runs in your browser, requires no signup, and gives you copy-ready Markdown for free.

Related tools

GitHub Profile README Generator

Build a complete profile README with bio, tech stack, stats, and social links.

GitHub Coding Streak Calculator

Calculate current and longest GitHub coding streaks with a shareable badge.