Your GitHub profile is often the first thing recruiters and fellow developers see. A great profile README can turn a blank page into a clear, professional snapshot of who you are and what you do — but writing one from scratch in markdown is tedious. You have to remember syntax, find the right stats widgets, style badges, and keep it readable on mobile.
I got tired of that. So I built GitHub Profile Generator — a free, AI-powered tool that turns your resume and a few clicks into a ready-to-paste profile README.
What it does
- Upload your resume (PDF) — The app extracts text and uses AI to pull out your name, title, skills, experience, and links so you don’t type everything by hand.
- Pick a template — Choose from several README styles: minimal, animated, developer-focused, and more. Each template is real markdown, so what you see is what you get.
- Edit everything — All fields are editable. Tweak your bio, add or remove skills, turn GitHub stats or streak cards on or off.
-
Export — Copy the markdown or download
README.md, then paste it into yourusername/usernamerepo. Done.
No account required. No paywall. It runs in the browser and talks to Supabase only for the optional AI bits (extract + refine).
Why I built it
I wanted my own profile to look good without spending an hour on markdown and image URLs. I also wanted something that:
- Works for non-technical folks (designers, PMs) who still want a nice GitHub profile.
- Uses real templates and real markdown, not a locked-in “profile builder” that only works on one site.
- Respects your data — you’re not signing up; you paste the result into your repo and you own it.
So I built a small React app, wired it to Supabase for AI (extract from resume, optional “refine” for better wording), and deployed it at githubprofilegenerator.com.
Features that actually matter
- AI extraction — Paste or upload a PDF; the app suggests name, title, skills, links, and a short bio so you don’t start from zero.
- Templates — Different layouts (minimal, with typing effects, stats-heavy, etc.). You pick one and your data is dropped in.
- GitHub stats — Optional cards for stats, top languages, and streak, with your username filled in.
- Badges — Social links, “Buy Me a Coffee”, Ko-fi, GitHub Sponsors — only if you want them.
- Responsive — The generator and the generated README both work on small screens.
Everything is optional. If you don’t use AI, you can still fill the form manually and export.
How to use it (30 seconds)
- Go to githubprofilegenerator.com.
- (Optional) Upload your resume and click “Extract with AI” to prefill the form.
- Choose a template you like.
- Edit any field (bio, skills, links, stats toggles).
- Copy the markdown or download
README.md. - Create a repo named your GitHub username, add a
README.md, paste the content, and push.
Your profile will show the new README right away.
Tech stack (for the curious)
- Frontend: React, TypeScript, Vite, Tailwind, shadcn/ui.
- AI: Supabase Edge Functions calling OpenAI for resume extraction and optional refinement.
- Deploy: Docker, GitHub Actions, EC2 (and optionally EKS). The app is static + runtime config, so it’s cheap to host.
If you’re into that kind of thing, the flow is: build a static bundle, inject config at container start so Supabase URL/key aren’t baked in at build time, and serve with nginx.
Try it and share feedback
The goal is simple: make it easy for anyone to have a polished GitHub profile README without fighting markdown.
If you try it, I’d love to hear what’s missing or what would make it more useful for you — different templates, more badge options, or better AI defaults. Drop a comment or open an issue on the repo.
→ Create your profile README at githubprofilegenerator.com
Thanks for reading. If this saved you some time, consider sharing it with someone who’s still staring at an empty profile README.
Top comments (0)