Skip to content

yerdaulet-damir/crackthecv

Repository files navigation

CrackTheCV

CrackTheCV

The open-source Cursor for your CV. Paste job → Tailor CV → Export. Done in seconds.

No manual rewriting. No generic templates. No ATS bots blocking you. No subscription.

License Next.js

🚀 Try Live Demo · Report Bug · Request Feature


The Problem

You need to apply to a job online. So you:

read description → open Word → tweak summary → add keywords → rethink bullets → export PDF → submit

That's 7 steps. It takes 40+ minutes per application. And you still don't know if the ATS will actually parse your formatting correctly.

CrackTheCV collapses that into 3 steps. Paste job → Review AI edits → Export. Your tailored application is ready in seconds.


What You Get

  • 🪄 Instant Tailoring — Paste a job description, get a specifically tailored CV in seconds using advanced LLM agents.
  • 📝 The "Cursor" Experience — Natural language Chat Editor for your CV. Just type "make it sound more metrics-driven" or "highlight my PM skills more."
  • 🔄 Transparent Changelog — See exactly what the AI changed and why, with side-by-side highlighting. You're always in control.
  • 🎭 Multi-Persona Profiles — Save multiple career identities (e.g., Backend Engineer vs. Product Manager) and tailor from the perfect base.
  • 📄 ATS-Friendly PDF Export — Clean, easily parseable PDF output that passes automated screening.
  • ⚡ Blazing Fast — Built on Next.js 15, React 19, and FastAPI. No lag, no loading spinners.

Quick Start

git clone https://github.com/yerdaulet-damir/crackthecv.git
cd crackthecv

Backend (/backend)

cd backend
python -m venv venv
source venv/bin/activate
pip install -r requirements.txt
cp .env.example .env  # configure your env vars (Supabase + OpenAI)
uvicorn main:app --reload

Frontend (/crackthecv)

cd crackthecv
npm install
cp .env.example .env.local  # configure your env vars (Supabase defaults)
npm run dev

Visit http://localhost:3000 — start applying smarter.


Environment Variables

Backend (backend/.env)

Variable Description Required
OPENAI_API_KEY OpenAI API Key for AI operations Yes
SUPABASE_URL Supabase project URL Yes
SUPABASE_KEY Supabase service role key Yes

Frontend (crackthecv/.env.local)

Variable Description Required
NEXT_PUBLIC_SUPABASE_URL Supabase project URL Yes
NEXT_PUBLIC_SUPABASE_ANON_KEY Supabase anon key Yes
NEXT_PUBLIC_API_URL Local Backend API (e.g., http://localhost:8000) Optional

Tech Stack

Layer Technology
Framework Next.js 15, React 19
Styling Tailwind CSS
Backend API Python, FastAPI
AI Engines LangGraph, LangChain, OpenAI
Database Supabase (Postgres)
Identity/Auth Supabase Auth

How It Works

  1. Master Profile — Your complete career history, projects, and skills (never shown to employers).
  2. Job Analysis — AI parses the target job description to extract core requirements, keywords, and preferred tone.
  3. Tailoring — LangGraph AI matches your experience to the role accurately, adjusting bullet point strength without inventing fake history.
  4. Changelog Review — Every edit is cleanly tracked with before/after diffs so you can trust the changes.

Roadmap

  • Direct LinkedIn Profile Import
  • Cover letter generation
  • ATS simulation scoring
  • Browser extension for one-click tailoring

Contributing

  1. Fork the repo
  2. Create your branch: git checkout -b feature/my-feature
  3. Commit: git commit -m 'Add my feature'
  4. Push: git push origin feature/my-feature
  5. Open a Pull Request

All contributions welcome — code, docs, bug reports, and feedback.


License

MIT — use it, fork it, self-host it, build on it. No strings attached.


Star History

Star History Chart

About

The open-source Cursor for your CV. Paste job → Tailor CV → Export. Done in seconds.

Topics

Resources

Stars

Watchers

Forks

Contributors