contrib.rocks creates a free, auto-updating image of your GitHub repo's top contributors for your README. See how it works and how to embed it.
Category
Productivity
Pricing
Free, no paid tiers, from Free
Verified
Not yet
Last updated
July 19, 2026
Founded
2019
Headquarters
Not applicable; an open-source project with no registered company headquarters
What Is contrib.rocks?
contrib.rocks generates a single, self-updating collage image of a GitHub repository's top contributors, intended for embedding in a README file or project website.
It removes the manual work of listing and updating contributor names and avatars by hand, which otherwise quickly falls out of date as new people contribute.
How to Generate and Embed a Contributors Image
Users enter a repository name on contrib.rocks and receive an image preview along with ready-to-copy HTML and Markdown embed code.
The image can be customized with URL parameters controlling the maximum number of contributors shown and the number of columns in the grid, and it can optionally include anonymous contributors identified by commit email.
Who Maintains contrib.rocks and Is It Free?
The tool is created and maintained by developer Suguru Inatomi, known as lacolaco on GitHub, with underlying open-source code dating to 2019.
It is completely free with no account or paid tier, though as an individually maintained project it has no formal support commitment or service-level agreement.
Key Features
Auto-generated contributor collage — Creates a single image showing avatars of a GitHub repository's top contributors.
Self-updating image URL — The embedded image reflects new contributors automatically without manual README edits.
Ready-to-copy embed snippets — Provides HTML and Markdown code to paste directly into a README or webpage.
Customizable contributor count — A URL parameter controls the maximum number of contributor avatars displayed.
Customizable grid layout — A URL parameter controls how many avatars appear per row.
Anonymous contributor support — Optionally includes contributors identified only by commit email address.
Clickable contributor avatars — Each avatar links back to that contributor's GitHub profile.
No account required — Generates an image immediately from a repository name with no sign-up needed.
Pros & Cons
Pros
Completely free with no paid tier or account requirement
Extremely simple to set up by just entering a repository name
Image stays current automatically without manual README edits
Widely recognized and trusted within the open-source community
Lightweight, single-purpose tool with no unnecessary complexity
Cons
Maintained by a single individual rather than a company, so there is no formal support or service-level agreement
Very large repositories with many contributors may need manual tuning of the count and column parameters
No built-in contributor recognition features beyond the image itself, such as points or leaderboards
Relies on GitHub's public API, so GitHub outages or rate limits can affect image generation
Limited to GitHub repositories, without support for GitLab, Bitbucket, or other hosting platforms
Frequently Asked Questions
What does contrib.rocks do?
It generates a self-updating collage image of a GitHub repository's top contributors for embedding in a README or website.
Is contrib.rocks free?
Yes, it is completely free with no paid tiers or account requirement.
Who created contrib.rocks?
It was created and is maintained by developer Suguru Inatomi, known as lacolaco on GitHub.
How do I add a contrib.rocks image to my README?
Enter your repository name on the contrib.rocks site and copy the generated HTML or Markdown embed code into your README.
Can I control how many contributors are shown?
Yes, a URL parameter lets you set the maximum number of contributors displayed, and another controls the grid's column count.
Does contrib.rocks work with private repositories?
The tool is designed around public GitHub repositories; its behavior with private repositories is not clearly documented in public sources.
Does clicking a contributor's avatar go anywhere?
Yes, each avatar links to that contributor's GitHub profile.
Is contrib.rocks the same as All Contributors?
No, All Contributors is a separate specification and toolset with badges and manual contribution-type tagging, while contrib.rocks focuses solely on generating a single auto-updating avatar collage.