Turn your GH profile into clean SVG cards that you can drop into any README.
Stats, languages, pinned repos, gists, and coding time. One small server, no Node, no JavaScript.
Deploy your own instance first, then add these to your README. Replace YOUR_INSTANCE with your deployment URL, for example https://your-app.vercel.app.




| Card | Endpoint |
|---|---|
| Stats | /api?username= |
| Top Languages | /api/top-langs?username= |
| Pinned Repo | /api/pin?username=&repo= |
| Gist | /api/gist?id= |
| WakaTime | /api/wakatime?username= |
Every card accepts these.
| Option | What it does |
|---|---|
theme |
Picks one of the 81 themes |
title_color |
Color of the title |
text_color |
Color of the text |
bg_color |
Background color, gradients work too |
hide_border |
Removes the card border |
locale |
Card language, try locale=es |
cache_seconds |
How long the card is cached |
Cards also have their own extras. Stats supports hide, show_icons, hide_rank, and include_all_commits. Languages supports layout with compact, donut, and pie, plus langs_count and hide. WakaTime supports layout=compact and hide_progress.
- Fork this repo
- Import it on Vercel
- Add your GitHub token as
PAT_1in the environment variables - Deploy
cp .env.example .env # add your token
docker build -t grs .
docker run -p 9000:9000 --env-file .env grsOr with Go installed:
cp .env.example .env # add your token
go run ./cmd/server- Idea inspired by github-readme-stats.