A tiny pixel pet for your GitHub README that eats your commits.
Add one line of markdown and an animated Nomling moves into your profile. It shows your real contribution stats: it munches when you commit, keeps your streak, celebrates your big days, and falls asleep if you go quiet.
[](https://nomlings.cc/badge)That's it. No signup, no token, no config. Clicking the pet leads back to the Nomlings, so every adopted badge is also a door here.
These are live, rendered from each account's real activity right now:
| Linus Torvalds built Linux and git. His Wispling has been eating kernel commits since 1991. | |
| PewDiePie hatched a Sproutling. It eats dotfiles and self-hosted AI. | |
| Sindre Sorhus maintains a thousand npm packages. His Twinkling never goes hungry. | |
| Andrej Karpathy's Peckling naps between training runs. It wakes up hungry. |
Yours is already waiting at https://nomlings.cc/badge/YOUR-USERNAME. Go say hi.
The badge reads your contribution calendar (the same numbers as your profile graph, private contributions included when your profile shows them) and turns it into a mood:
Here is a Buzzling running through all five (these are live, animated):
| Mood | Meaning |
|---|---|
🎉 celebrating |
15+ contributions today. On fire. |
😋 eating |
you contributed today (with your current streak) |
🙂 idle |
active this week, nothing yet today |
💤 sleeping |
zero contributions in 7 days |
🥚 egg |
no contributions in the last year. Hatch it. |
Your pet's level grows with your yearly total, and the badge always shows the real numbers: contributions today, your streak, and your last-year total.
Your species is hatched from your username, but there are ten Nomlings
and you can pick any of them with ?pet=. Here is the whole family:
nomling |
enderling |
peckling |
wispling |
byteling |
sproutling |
hopling |
twinkling |
sporeling |
buzzling |
[](https://nomlings.cc/badge)| Param | Example | Effect |
|---|---|---|
pet |
?pet=wispling |
pick your species |
scale |
?scale=6 |
pixel size, 2 to 8 (default 4) |
color |
?color=%23ff8833 |
sprite color (default GitHub green) |
label |
?label=off |
sprite only, no text |
?scale=2 for a footnote, default 4, ?scale=6 for a hero:
Any hex via ?color= (URL-encode the # as %23):
?label=off drops the text. Perfect next to your name or in a table:
Combine anything: https://nomlings.cc/badge/YOU?pet=hopling&scale=6&color=%23ff8833
Is it free? Yes.
Why does my badge lag my latest commit? Renders are cached for a few hours to keep things fast and gentle. Your pet notices, just not instantly.
Do private contributions count? They count whenever your GitHub profile is set to show private contribution activity, because the badge reads the same calendar your profile displays.
Is the code open source? The service is closed source: the Nomling characters and pixel art are original work and this keeps them home. Bugs, ideas, and species requests are very welcome in this repo's issues.
Where do Nomlings come from? They are the desktop pets that live next to your terminal and eat your Claude Code tokens. Meet the full 3D version at Nomlings/app.
Nomling species designs and artwork © Nomlings. All rights reserved.