git-aura

RPG-style developer trading cards generated from your GitHub profile.

Turn your GitHub profile into a collectible trading card. Your commit patterns, languages, stars, and activity are analyzed to assign you an RPG class, power level, and beautifully rendered SVG card you can embed anywhere.

https://your-instance.com/api/card/torvalds.svg

Why git-aura?

• Real RPG class system - Night Owl, Polyglot, Code Warrior, PR Speedrunner, and more. Your class is determined by actual coding behavior analysis (commit times, language diversity, PR velocity).
• Beautiful SVG cards - Gradient themes, animated holographic effects, stat bars, language breakdown. Looks great in any README.
• Zero config embedding - One URL gives you an SVG image. Drop it into your GitHub profile README in 10 seconds.

Quickstart

# Clone and install
git clone https://github.com/yourname/git-aura.git
cd git-aura
pip install -r requirements.txt

# Run the server
python app.py

# Open http://localhost:5000
# Enter any GitHub username to generate a card

Features

• 8 Developer Classes: Night Owl, Early Bird, Polyglot, Specialist, PR Speedrunner, Code Warrior, Weekend Warrior, Open Source Champion
• XP and Level System: Logarithmic scaling from stars, forks, repos, and followers
• Language Breakdown: Top languages with colored bars matching GitHub's language colors
• Embeddable SVG: Use in README files, websites, or anywhere that supports images
• JSON API: Programmatic access to all card data at /api/card/<username>.json
• Live Data: Fetches directly from GitHub's public API (no auth required for basic data)

Architecture

GitHub Username
      |
      v
GitHub API (profile + repos + events)
      |
      v
Stats Calculator (languages, commit times, PR velocity)
      |
      v
Class Determiner (scoring algorithm across 8 classes)
      |
      v
SVG Generator (gradients, stat bars, animated effects)
      |
      v
Flask Routes (/card/user, /api/card/user.svg, /api/card/user.json)

API Endpoints

Route	Description
GET /	Landing page with search form
GET /card/<username>	Card display page with embed codes
GET /api/card/<username>.svg	Raw SVG card image
GET /api/card/<username>.json	Card data as JSON

Embed in Your README

[![git-aura card](https://your-instance.com/api/card/YOUR_USERNAME.svg)](https://your-instance.com/card/YOUR_USERNAME)

Contributing

1. Fork the repository
2. Create a feature branch (git checkout -b feature/new-class)
3. Add your changes (new classes go in generator.py CLASSES dict)
4. Test with python app.py
5. Submit a pull request

License

MIT - see LICENSE for details.