github-creature

KO | EN

gitlite — search

#python #hacktoberfest #ai #typescript #machine-learning #deep-learning #linux #docker #java #windows #kubernetes #awesome-list #mcp #ios

github-creature

(★ 95)

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

github-creature Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# GitHub Creature

Generate a **shareable fantasy creature card** from a GitHub profile.

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

```bash
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`.

github-creature

github-creature Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

github-creature

github-creature Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README