Paste a job description + your CV. Get a scored evaluation, specific rewrites, and a tailored PDF.
An open source, privacy-first CV builder for tech professionals. Built by the Tech Immigrants community.
Good CV tools are expensive. Many job seekers — especially immigrants, career changers, and people in countries with restricted internet — can't access them. We're building a free, open source alternative backed by real hiring research.
What makes this different:
- Scoring based on 250+ researched sources from FAANG recruiters, AI hiring managers, and industry experts
- Role-specific evaluation (not one-size-fits-all)
- Privacy-first: works offline, no data collection
- Transparent: every rule is auditable, every score is explainable
┌──────────┐ ┌──────────────┐ ┌──────────────┐
│ Your CV │ ──▶ │ CV Builder │ ──▶ │ Score: 4.2/5 │
└──────────┘ │ Engine │ │ 3 rewrites │
┌──────────┐ │ │ │ 5 issues │
│ JD │ ──▶ │ (6 scoring │ │ Keywords gap │
│(optional)│ │ dimensions) │ │ Tailored CV │
└──────────┘ └──────────────┘ └──────────────┘
| Dimension | What it measures |
|---|---|
| Shipped Evidence | Real work in production, not theory |
| Quantified Impact | Numbers in every bullet (%, $, users) |
| Tooling Visibility | Specific tools named, matching the JD |
| ATS Compatibility | Will it parse correctly in applicant tracking systems? |
| Keyword Match | Terminology from the JD present in your CV |
| Public Proof | GitHub, blog, portfolio links that verify claims |
Weights vary by role type. An AI Engineer's CV is scored differently than a Product Manager's.
# Clone and build
git clone https://github.com/TechImmigrants/cv-builder.git
cd cv-builder
pnpm install
pnpm build
# Evaluate your CV
pnpm --filter @cv-builder/cli start evaluate ./my-cv.md
# Evaluate against a specific job description
pnpm --filter @cv-builder/cli start evaluate ./my-cv.md --jd ./job.md
# List available role archetypes
pnpm --filter @cv-builder/cli start archetypesA browser-based interface where you paste your CV and JD, get instant feedback, and export a tailored PDF. No sign-up required, no data leaves your browser.
packages/
├── core/ # Evaluation engine (the brain)
├── cli/ # Command-line interface
└── web/ # Browser UI (coming soon)
See docs/ARCHITECTURE.md for the full technical design.
We have 26 contributors ready to build this together. Whether you're a first-time open source contributor or a senior engineer, there's work for you.
git clone https://github.com/TechImmigrants/cv-builder.git
cd cv-builder
pnpm install
pnpm build
pnpm test| Your skill | Start here |
|---|---|
| TypeScript / Backend | packages/core/ — scoring algorithms, new archetypes |
| React / Frontend | packages/web/ — build the UI from scratch |
| CLI / Node.js | packages/cli/ — new commands, output formatting |
| Research / Writing | research/ — find sources, validate rules |
| Design / UX | UI mockups, user flows, accessibility |
| DevOps / CI | .github/workflows/ — testing, releases, automation |
good first issue— Small, self-contained tasks perfect for newcomersarchetype— Add a new role type (great for domain experts)rules— New CV evaluation ruleshelp wanted— Needs community inputweb-ui— Frontend/design workcore— Engine logic
See CONTRIBUTING.md for the full guide.
Currently built-in:
- AI Product Manager
- AI Engineer
- Backend Engineer
- Frontend Engineer
- DevOps / SRE
- Data Engineer
Want to add your role? Use the New Archetype issue template and submit a PR. Each archetype needs 15+ keywords, evaluation weights, action verbs, and anti-patterns.
- Core evaluation engine with 6 dimensions
- 6 role archetypes
- Universal anti-pattern detection
- CLI: basic evaluate command
- Unit tests for scoring logic
- Web UI: paste and score screen
- LLM-enhanced mode (rewrite suggestions)
- PDF export
- 15+ role archetypes
- Keyword gap analysis with suggestions
- Localization (multiple languages)
- Side-by-side tailoring editor
- Before/after examples library
- VS Code / Cursor extension
- Self-hosted deployment guide
- Telegram Channel: Tech Immigrants
- Telegram Group: Tech Immigrants
- YouTube: Tech Immigrants
- LinkedIn: Tech Immigrants
- X: @tech_immigrants
Our rules are backed by data, not vibes. See:
- research/sources.md — All 250+ sources with citations
- research/data/ — Structured market data
- docs/ARCHITECTURE.md — Technical design decisions
MIT — Use it, fork it, build on it. Free forever.