Terms of use
GitBanners is a free service for making banner images from public GitHub data. By using the site, its images, the API or the MCP server you agree to the terms below.
What you may do
- Make banners of public GitHub users, organizations and repositories, and embed or upload them wherever images are allowed: READMEs, websites, profiles, social media.
- Call the JSON API and the MCP server from your own software, including automated agents, within the rate limits.
Acceptable use
In return, do not:
- Work around the rate limits, for example by spreading requests over many addresses.
- Use the service to harass someone, or to pass a banner off as a statement by the account it shows.
- Present GitBanners or its banners as a product of GitHub.
- Probe, overload or attack the service, or try to reach data that is not public.
Access can be limited or removed for use that harms the service or other people.
Rate limits
The API and the MCP server allow 120 requests per 60 seconds per client, and search 60 requests per 60 seconds. Banner images are cached instead of limited. The limits can change; the current values are in the docs and in the headers of every API answer.
Accounts and Pro
- Signing in uses your GitHub account. You are responsible for what is done with it here.
- Pro is unlocked by starring the markeljan/gitbanners repository and lasts as long as the star does. It is not sold, and it carries no guarantee of service.
- You can delete your account at any time from the dashboard. The privacy page says what is stored and for how long.
GitHub data
Banners are drawn from public data published on GitHub. That data belongs to the people and projects it describes, and it can be out of date or incomplete: a banner is a picture of what GitHub reported, not a certified record.
Availability and changes
- The service is offered without an uptime guarantee. It depends on GitHub and on its hosting provider, and either can fail.
- Features, limits and these terms can change. Breaking changes to the API follow the versioning policy, with at least 90 days of notice.
- The service can be discontinued. If that happens, embedded banners will stop loading.
No warranty
GitBanners is provided as is, without warranty of any kind. As far as the law allows, the maintainer is not liable for any damage that results from using it or from not being able to use it.
Trademarks and licenses
- GitHub is a trademark of GitHub, Inc. GitBanners is an independent project and is not affiliated with, sponsored by or endorsed by GitHub.
- Mona Sans is used under the SIL Open Font License 1.1, Octicons under the MIT license, and Twemoji artwork under CC BY 4.0.
- Theme names such as Dracula, Nord or Catppuccin refer to the colour schemes of those projects and belong to their authors.
Contact
GitBanners is run by the GitHub user markeljan. The contact page says how to get in touch.