Paste your CV and an optional job description. Get a 0–5 evaluation across six dimensions, with a prioritised list of issues and fixes.
This is the first community MVP: it scores an existing resume, it does not generate, tailor, or rewrite one. An open source, privacy-first CV evaluator 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 archetypesClone the repo, open Claude Code at the root, and run /evaluate-cv ./your-resume.pdf. The evaluation runs entirely on your machine with your own agent — no server, no account, nothing leaves your computer. No build needed.
See apps/cli/README.md for the full guide.
pnpm dev # boots at http://localhost:3000A browser-based interface where you paste your CV and JD, get instant
feedback, and read the full dimension breakdown. No sign-up, no data leaves
your browser. PDF upload is not supported yet — use .txt or .md.
Full guide: docs/LOCAL_DEMO.md.
- The web UI runs entirely in your browser. Nothing is sent to a server.
- The CLI reads files locally and prints to stdout. Nothing is uploaded.
- There is no telemetry, no analytics, no cookies.
- Results in the web UI are stored in your browser's
localStorageonly.
Do not paste your real CV into GitHub issues. Issues are public. Before sharing an example, anonymize it first — see docs/FEEDBACK_GUIDE.md.
packages/
├── schemas/ # Zod contract shared by every surface
├── intelligence/ # Rubric, archetypes, validators (the brain)
├── prompts/ # extract / score / validate-claims prompt pack
├── core/ # Deterministic evaluation engine
├── cli/ # Command-line interface
└── eval/ # Golden fixtures (pnpm eval)
apps/
├── cli/ # Power-user quickstart
└── web-ui/ # Browser UI (coming soon)
.claude/ # Claude Code skill + slash commands (power-user surface)
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/intelligence/ — rubric, new archetypes, validators |
| React / Frontend | apps/web-ui/ — 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
- Machine Learning Engineer
- Backend Engineer
- Frontend Engineer
- QA / Test 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
- 8 role archetypes
- Universal anti-pattern detection
- CLI: basic evaluate command
- Web UI: paste and score screen (local demo)
- Eval harness with golden fixtures
- Localization-ready code structure (no strings in wrong place)
- Privacy model: no telemetry, no upload
- Unit tests for scoring logic
- PDF text extraction
- 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.