Skip to content

Repository files navigation

GitHub Creature

Generate a shareable fantasy creature card from a GitHub profile.

CleanShot 2026-01-09 at 13 46 11@2x

You paste a GitHub profile URL, the app fetches your GitHub stats (contributions, followers, stars), uses an AI model to invent a creature + generate an image, then saves it so you get a permanent page at /<username>. There’s also a leaderboard for top creatures by contributions, followers, and stars.

Screenshot

What you can do

  • Summon a creature from a GitHub profile URL
  • Share a /<username> link with nice social previews
  • Download the creature card
  • Browse leaderboards (contributions / followers / stars)

Running locally

pnpm i
pnpm dev

Environment variables

Create .env.local (or .env) with:

  • DATABASE_URL: Postgres connection string (Neon)
  • GITHUB_TOKEN: GitHub token for the API (to read contributions/followers)
  • BLOB_READ_WRITE_TOKEN: Vercel Blob token (needed to upload generated images when running locally)
  • AI provider key: this project uses the Vercel AI Gateway

Then open http://localhost:3000.

About

An open source project where you summon your EPIC creature card based on your GitHub stats.

Resources

Contributing

Stars

93 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages