Thanks to visit codestin.com
Credit goes to Github.com

Skip to content

A fun little script that turns your GitHub activity into a digital pet! Codey is a project that updates daily based on your commits and merged pull requests, reflecting your coding journey in a cute, animated SVG badge.

Notifications You must be signed in to change notification settings

VolkanSah/Codey

Repository files navigation

🐾 Codey - Your Brutally Honest GitHub Pet

RPG "No Mercy" Edition - Where Your Code Gets Judged For Real

Codey - Your GitHub Pet

Codey isn't your typical GitHub stats badge. This is a full-blown RPG system that analyzes your entire coding personality, judges your contributions with zero mercy, and evolves into different creatures based on what you actually code.

No fake motivation. No participation trophies. Just raw, unfiltered feedback on your dev life.

Daily updates via GitHub Actions. Tracks commits, stars, languages, streaks, and more β€” then brutally scores you on traits like creativity, curiosity, and teamwork. Your pet evolves (or devolves) based on your real GitHub behavior.

⚠️ Current Status: Dev build, needs testers brave enough to face the truth!

Why Codey is Different

Standard GitHub stats: "Wow, you made 500 commits! πŸŽ‰"
Codey: "500 commits, 2 stars, 0 followers. Are you coding in a cave?"

This isn't about counting contributions. It's about revealing your true coding personality through a harsh but rewarding RPG system that tracks:

  • Social Status β€” Based on total stars earned (not given)
  • Personality Type β€” Calculated from follower/following ratio (Influencer? Explorer? Balanced?)
  • Dominant Language β€” Your pet evolves based on what you actually code (🐍 Python dragon, 🦊 JavaScript fox, πŸ¦€ Rust crab, etc.)
  • Professional Traits β€” Creativity, curiosity, teamwork β€” tracked and displayed
  • Achievements β€” Unlock badges for real milestones: πŸ”₯ Monthly Warrior, πŸ’― Commit Master, ⭐ Social Star
  • Prestige System β€” Hit max level? Reset everything for exclusive rewards and flex harder

What Codey Actually Tracks

  • Daily & all-time commit counts
  • Stars earned (across ALL your repos)
  • Code streak (consecutive days coding)
  • Most-used programming language
  • Social metrics (followers, following, forks)
  • Weekend warrior status (yes, Saturday commits count double)
  • Seasonal event participation (Hacktoberfest, Advent of Code)

Important: Codey only counts stars on YOUR repos. Forking popular projects won't save you here.

The No Mercy System

Codey uses an unforgiving leveling algorithm where:

  • Low activity = Your pet gets sad, tired, or dies (temporarily)
  • Inconsistent commits = Streak breaks, XP penalties
  • No stars on repos = Social status tanks
  • Weekend coding = Energy boost, level gains
  • Seasonal events = Special bonuses and visual upgrades

Your pet has health, energy, mood, and advanced RPG stats that change based on real behavior:

Mood States:
😊 happy β†’ β˜• tired β†’ 😰 stressed β†’ 😑 angry β†’ πŸ’€ dead
           β†˜οΈ πŸ€” bored β†’ 😴 sleepy β†’ 😡 overwhelmed
                          β†˜οΈ ✨ inspired

The exact formulas and brutal penalties are documented in Behind the Scenes β€” if you dare to look.

Pet Evolution System

Your Codey evolves based on your dominant programming language:

Language Pet Form Why
Python 🐍 Dragon Classic, powerful
JavaScript 🦊 Fox Quick, adaptable
Rust πŸ¦€ Crab Memory-safe beast
Go 🐹 Gopher Fast, concurrent
TypeScript πŸ¦… Eagle Type-safe ruler
Ruby πŸ’Ž Gem Guardian Elegant, refined
PHP 🐘 Elephant Never forgets
C/C++ βš”οΈ Knight Low-level warrior
Java β˜• Coffee Spirit Enterprise soul
...and more 🐲 Mythical forms Unlock legendary creatures

Prestige Mode: After maxing out, reset your stats to unlock mythical forms and special visual badges that prove you're a coding veteran.

Setup - Make Codey Your Pet

Quick Start (3 Steps)

  1. Fork or copy this repo
  2. Configure tracking mode in .github/workflows/update_codey.yml
  3. Add the badge to your README

Step 1: Get the Files

Copy these into your repo:

your-repo/
β”œβ”€β”€ .github/
β”‚   └── workflows/
β”‚       └── update_codey.yml
β”œβ”€β”€ update_codey.py
└── requirements.txt

Step 2: Choose Your Tracking Mode

Edit the workflow's env section:

Option A - Track Single Repo:

env:
  GIT_REPOSITORY: 'YourUsername/YourProject'

Option B - Track Entire Account (Recommended for profile README):

env:
  GIT_REPOSITORY: 'YourUsername'

πŸ’‘ Pro Tip: For full stats including private repos, use a GITHUB_TOKEN with repo permissions.

Step 3: Embed in Your README

After the first workflow run, add this to your README.md:

![Codey - Your GitHub Pet](https://raw.githubusercontent.com/YOUR-USERNAME/YOUR-REPO/main/codey.svg)

Done! Codey updates daily at midnight UTC and judges you accordingly.

What Gets Tracked

Daily Stats

  • Commits today
  • Current streak
  • Energy level
  • Mood state

All-Time Stats

  • Total commits
  • Total stars earned
  • Level & XP
  • Achievements unlocked
  • Prestige rank (if applicable)

Professional Traits

  • Creativity β€” Based on project diversity
  • Curiosity β€” Following/exploring new repos
  • Teamwork β€” Collaboration metrics

Personality Type

Calculated from your social graph:

  • Influencer β€” High followers, low following
  • Explorer β€” Low followers, high following
  • Balanced β€” Even ratio

Achievements & Seasonal Events

Unlock special badges for major milestones:

  • πŸ”₯ Monthly Warrior β€” 20+ commits this month
  • πŸ’― Commit Master β€” 100+ total commits
  • ⭐ Social Star β€” 50+ stars earned
  • πŸŒ™ Night Owl β€” Commits after midnight
  • πŸ† Weekend Warrior β€” Saturday/Sunday coding

Seasonal Boosts:

  • πŸŽƒ Hacktoberfest (October) β€” Double XP for PRs
  • πŸŽ„ Advent of Code (December) β€” Special daily challenges
  • πŸŽ‚ Repo Birthday β€” Bonus on your repo's anniversary

Roadmap

  • PostgreSQL integration for historical tracking
  • Multi-language pet forms (more creatures!)
  • Team/organization support
  • API endpoint for live stats
  • More brutal judging algorithms (yes, really)
  • Community leaderboards (compare your pain)

πŸ› Known Issues (Fixed)

  • βœ… Everyone was a dragon β€” Evolution system fixed
  • βœ… Codey on drugs β€” Energy calculation normalized
  • βœ… Some dragons β€” Species diversity restored

🀝 Contributing

Found a bug? Want to add features? PRs welcome!

Ways to contribute:

  • Test the No Mercy Edition and report issues
  • Add new pet forms for different languages
  • Improve the brutal scoring algorithm
  • Design new achievements
  • Write better insults for low performers (kidding... or am I?)

License

Apache 2.0 License by Volkan KΓΌcΓΌkbudak

Use it, fork it, judge yourself with it. Just keep the attribution and don't blame me when Codey roasts you.

πŸ’¬ About the Author

Built by Volkan Sah β€” A developer who believes in honest feedback, even when it hurts.

Other projects:

⚠️ Disclaimer

Codey is brutally honest. If you have thin skin about your coding habits, maybe stick to regular GitHub stats.

This pet will:

  • Call out your inconsistency
  • Judge your commit frequency
  • Question your star count
  • Mock your broken streaks

But it will also:

  • Celebrate real achievements
  • Reward consistent effort
  • Evolve with your skills
  • Make you a better developer (probably)

Remember: Codey is just code. But if it makes you code more, mission accomplished. 🎯

Live Example

Check out my Codey in action: volkansah.github.io/Codey

Spoiler: Even I get roasted sometimes. That's the point.

Made with β˜• and brutal honesty

⭐ Star this repo if Codey made you cry (in a good way)

About

A fun little script that turns your GitHub activity into a digital pet! Codey is a project that updates daily based on your commits and merged pull requests, reflecting your coding journey in a cute, animated SVG badge.

Topics

Resources

Stars

Watchers

Forks

Sponsor this project

  •  

Contributors 2

  •  
  •  

Languages