GitHub Profile Trophy (Go Implementation)

• English
• 简体中文
• Deutsch
• Italiano
• 한국어
• 日本語

No deployment needed! This is a 100% compatible Go implementation of the GitHub Profile Trophy project. You can use it as a direct replacement for the original service - just swap the URL and all your existing parameters will work exactly the same.

• 🎯 100% API Compatible - Use the exact same URL parameters as the original project
• 🚀 No Deployment Required - Self-hosted solution, full control over your data
• ⚡ High Performance - Built with Go for better performance and lower resource usage
• 🔄 Multi-Token Support - Handle higher API rate limits with multiple GitHub tokens
• 💾 Smart Caching - Built-in memory cache + optional Redis support for faster responses
• 🎨 20+ Beautiful Themes - All original themes supported plus more
• 🛡️ Production Ready - Retry mechanisms, error handling, and robust architecture

If you're already using the original GitHub Profile Trophy, simply replace the base URL:

Before (Original):

[![trophy](https://github-profile-trophy.vercel.app/?username=ryo-ma&theme=onedark)](https://github.com/ryo-ma/github-profile-trophy)

After (This Project):

[![trophy](http://localhost:8080/?username=ryo-ma&theme=onedark)](https://github.com/ryo-ma/github-profile-trophy)

All parameters work exactly the same! No changes needed to your existing code.

Of course, we recommend using the GitHub Actions approach instead. Simply update the original request parameters in the Action file:

Before using this example, create a repository secret named PROFILE_STATS_TOKEN containing a dedicated PAT. Follow the action’s token setup instructions. An unset secret resolves to an empty value, causing the action to fall back to the repository-scoped GITHUB_TOKEN.

public_repo also grants read/write access to public repositories accessible to the token owner; this token is not read-only. Use a personal access token (classic) with public_repo and read:user for public statistics. For private repositories, replace public_repo with repo (which also grants repository write access). Set an expiration date. Save the token under Settings → Secrets and variables → Actions → New repository secret in the repository running this workflow.

- name: Generate trophy card
  uses: soulteary/github-profile-trophy-action@v1
  with:
    options: 'username=${{ github.repository_owner }}&theme=onedark'
    path: .github/assets/trophy.svg
    token: ${{ secrets.PROFILE_STATS_TOKEN }}

• ✅ Trophy card generation with multiple ranks (SSS, SS, S, AAA, AA, A, B, C)
• ✅ 15+ trophy types (Stars, Commits, Followers, Issues, PRs, Repositories, Reviews, etc.)
• ✅ Secret trophies (MultiLanguage, AllSuperRank, AncientAccount, etc.)
• ✅ 20+ themes support
• ✅ Customizable layout (column, row, margins)
• ✅ Filtering by title and rank
• ✅ Caching support (memory + Redis)
• ✅ Multi-token GitHub API support with retry mechanism

All examples below use the same URL parameters as the original project. Just replace the base URL!

[![trophy](http://localhost:8080/?username=ryo-ma)](https://github.com/ryo-ma/github-profile-trophy)

[![trophy](http://localhost:8080/?username=ryo-ma&theme=onedark)](https://github.com/ryo-ma/github-profile-trophy)

[![trophy](http://localhost:8080/?username=ryo-ma&title=Stars,Followers)](https://github.com/ryo-ma/github-profile-trophy)

[![trophy](http://localhost:8080/?username=ryo-ma&rank=S,AAA)](https://github.com/ryo-ma/github-profile-trophy)

[![trophy](http://localhost:8080/?username=ryo-ma&column=3&row=2&margin-w=15&margin-h=15)](https://github.com/ryo-ma/github-profile-trophy)

💡 Tip: All URL parameters from the original project work identically here. No need to change your existing README code!

You can use github-profile-trophy-action to generate trophy cards in your CI/CD pipeline:

Create a repository secret named PROFILE_STATS_TOKEN containing a dedicated PAT for profile statistics. See the action’s token setup and troubleshooting. Checkout and push continue using the automatic GITHUB_TOKEN; contents: write does not grant it cross-repository access.

name: Generate Trophy

on:
  schedule:
    - cron: "0 0 * * *" # Runs once daily at midnight
  workflow_dispatch:

jobs:
  generate:
    runs-on: ubuntu-latest
    
    permissions:
      contents: write
    
    steps:
      - name: Checkout code
        uses: actions/checkout@v4

      - name: Generate trophy card
        uses: soulteary/github-profile-trophy-action@v1
        with:
          options: 'username=${{ github.repository_owner }}&theme=gruvbox&column=7&margin-w=15&margin-h=15'
          path: .github/assets/trophy.svg
          token: ${{ secrets.PROFILE_STATS_TOKEN }}

      - name: Commit trophy card
        run: |
          git config user.name "github-actions[bot]"
          git config user.email "41898282+github-actions[bot]@users.noreply.github.com"
          git add .github/assets/trophy.svg
          git commit -m "Update trophy card" || exit 0
          git push

Then embed the generated image in your README:

![Trophy](.github/assets/trophy.svg)

# Run with Docker - no installation needed!
docker run -d \
  -p 8080:8080 \
  -e GITHUB_TOKEN1=your_github_token_here \
  --name github-profile-trophy \
  soulteary/github-profile-trophy:latest

That's it! Your service is now running at http://localhost:8080 and ready to use with all your existing URLs.

# Clone the repository
git clone https://github.com/soulteary/github-profile-trophy.git
cd github-profile-trophy

# Build
go build -o github-profile-trophy ./cmd/server

# Run (set your GitHub token)
GITHUB_TOKEN1=your_github_token_here ./github-profile-trophy

go install github.com/soulteary/github-profile-trophy/cmd/server@latest

Create a .env file or set environment variables:

# GitHub Personal Access Token (required)
GITHUB_TOKEN1=your_github_token_here
# You can configure multiple tokens to increase API rate limits
GITHUB_TOKEN2=your_second_token_here

# Server port (optional, default: 8080)
PORT=8080

# Cache configuration (optional)
ENABLE_REDIS=false
REDIS_HOST=localhost
REDIS_PORT=6379
REDIS_USERNAME=
REDIS_PASSWORD=

# Production mode (optional)
NODE_ENV=production

⚡ Performance Tip: Configure multiple GITHUB_TOKEN1, GITHUB_TOKEN2, etc. to handle higher API rate limits automatically.

Choose from 20+ beautiful themes! All themes from the original project are supported.

100% compatible with the original project! All parameters work exactly the same.

• Stars
• Commits
• Followers
• Issues
• Pull Requests
• Repositories
• Reviews

• MultiLanguage (10+ languages)
• AllSuperRank (all base trophies are S rank or higher)
• LongTimeUser (10+ years)
• AncientUser (before 2010)
• OGUser (before 2008)
• Joined2020 (joined in 2020)
• Organizations (3+ organizations)
• Experience (account duration)

Ranks are: SECRET, SSS, SS, S, AAA, AA, A, B, C, UNKNOWN

.
├── cmd/
│   └── server/          # Server entry point
│       └── main.go
├── internal/
│   ├── api/             # API handlers
│   ├── cards/           # Card rendering logic
│   ├── common/          # Common utilities
│   ├── fetchers/        # Data fetchers (GitHub API)
│   ├── themes/          # Theme system
│   └── trophies/        # Trophy system
├── go.mod
└── README.md

Production Ready! All core features are complete and tested.

• ✅ Project base structure
• ✅ HTTP server (Gin framework)
• ✅ GitHub API integration (GraphQL)
• ✅ Retry mechanism and multi-token support
• ✅ Cache handling (memory + Redis)
• ✅ Theme system (20+ themes)
• ✅ All trophy types (15+ types)
• ✅ Rank calculation
• ✅ All API endpoints
• ✅ 100% API compatibility with original project

Contributions are welcome! If you have any ideas or find issues, please:

1. Fork this project
2. Create your feature branch
3. Commit your changes
4. Push to the branch
5. Open a Pull Request

This project is licensed under the MIT License.