Resume-Matcher README

The project's README from github.com/srbhr/Resume-Matcher. As one markdown file: README.md.

Resume Matcher

Resume Matcher

𝙹𝚘𝚒𝚗 𝙳𝚒𝚜𝚌𝚘𝚛𝚍 ✦ 𝚆𝚎𝚋𝚜𝚒𝚝𝚎 ✦ 𝙷𝚘𝚠 𝚝𝚘 𝙸𝚗𝚜𝚝𝚊𝚕𝚕 ✦ 𝙲𝚘𝚗𝚝𝚛𝚒𝚋𝚞𝚝𝚘𝚛𝚜 ✦ 𝚂𝚙𝚘𝚗𝚜𝚘𝚛 ✦ 𝚃𝚠𝚒𝚝𝚝𝚎𝚛/𝚇 ✦ 𝙻𝚒𝚗𝚔𝚎𝚍𝙸𝚗 ✦ 𝙲𝚛𝚎𝚊𝚝𝚘𝚛

English | Español | 简体中文 | 日本語

The AI harness to build tailored resumes for each job application with Claude, ChatGPT, DeepSeek, Kimi, GLM, Gemma, and other LLMs. Supports both local and remote LLMs.

Resume Matcher Demo


Stars Apache 2.0 Forks version

Discord Website LinkedIn

srbhr%2FResume-Matcher | Trendshift

Vercel OSS Program

[!IMPORTANT]

The project needs your help and support. If you can donate a small amount, that will help me to continue developing and improving Resume Matcher.

Sponsor on GitHub Buy Me a Coffee

Sponsoring for a company? Put your logo in front of 27k+ developers → become a sponsor ↓

Getting Started

Resume Matcher works by creating a master resume that you can use to tailor for each job application. Installation instructions here: How to Install

How It Works

  1. Upload your master resume (PDF or DOCX)
  2. Paste a job description you're targeting
  3. Review AI-generated improvements and tailored content
  4. Cover Letter and optional interview preparation for the job application
  5. Customize the layout and sections to fit your style
  6. Export as a professional PDF with your preferred template

Stay Connected

Discord

Join our Discord for discussions, feature requests, and community support.

LinkedIn

Follow us on LinkedIn for updates.

Star Resume Matcher

Star the repo to support development and get notified of new releases.

Sponsors

sponsors

Resume Matcher is free and open-source, kept alive by its sponsors and backers. If it helps you, please consider supporting its development.

Companies backing Resume Matcher

Sponsor at a company tier and your logo + link + blurb lands here — in front of a community of 27k+ stars and 4.9k forks, featured on Trendshift and the Vercel OSS Program.

Sponsor Description
Apideck One API to connect your app to 200+ SaaS platforms (accounting, HRIS, CRM, file storage). Build integrations once, not 50 times. 🌐 apideck.com
Vercel Resume Matcher is a part of Vercel OSS // Summer 2025 Program 🌐 vercel.com
Cubic.dev Cubic provides PR reviews for Resume Matcher 🌐 cubic.dev
Kilo Code Kilo Code provides AI code reviews and coding credits to Resume Matcher 🌐 kilo.ai
ZanReal ZanReal is an AI-driven development company building scalable cloud solutions, from strategy and UX to DevOps, helping teams ship faster and turn ideas into production. 🌐 zanreal.com
✦ Your company here Reach 27k+ developers and 4.9k forks. Become a sponsor →

Read the Sponsorship Guide for tiers and details. Sponsors get a special thank-you in the README and on our website.

Support as an individual

donate

Every bit keeps Resume Matcher free and funds new features — and you'll be thanked in the README and on our website.

Platform Link
GitHub GitHub Sponsors
Buy Me a Coffee BuyMeACoffee

Creators' Note

srbhr

Thank you for checking out Resume Matcher. If you want to connect, collaborate, or just say hi, feel free to reach out! ~ Saurabh Rai ✨

You can follow me on:

Key Features

resume_matcher_features

Core Features

Master Resume: Create a comprehensive master resume to draw from your existing one.

Job Description Input

Resume Builder

Resume Builder

Paste in a job description and get AI-powered resume tailored for that specific role.

You can:

Cover Letter Generator

Generate tailored cover letters based on the job description and your resume.

Cover Letter

Interview Preparation

Generate structured, resume-grounded interview prep for saved tailored resumes. Use the Builder's Interview Prep tab on demand, or enable automatic generation in Settings.

Resume Scoring & Keyword Highlighting

Analyze your resume against the job description with a match score, keyword highlighting, and suggestions for improvement.

Resume Scoring and Keyword Highlight

PDF Export

Export your tailored resume and cover letter in PDF.

Templates

Template Name Preview Description
Classic Single Column Classic Template A traditional and clean layout suitable for most industries. 𝐕𝐢𝐞𝐰 𝐏𝐃𝐅
Modern Single Column Modern Template A contemporary design with a focus on readability and aesthetics. 𝐕𝐢𝐞𝐰 𝐏𝐃𝐅
Classic Two Column Classic Two Column Template A structured layout that separates sections for clarity. 𝐕𝐢𝐞𝐰 𝐏𝐃𝐅
Modern Two Column Modern Two Column Template A sleek design that utilizes two columns for better organization. 𝐕𝐢𝐞𝐰 𝐏𝐃𝐅

Internationalization

Roadmap

If you have any suggestions or feature requests, please feel free to open an issue on GitHub or discuss it on our Discord server.

How to Install

Installation

For detailed setup instructions, see SETUP.md (English) or: Español, 简体中文, 日本語.

Prerequisites

Tool Version Installation
Python 3.13+ python.org
Node.js 22+ nodejs.org
uv Latest astral.sh/uv

Quick Start

Fastest for MacOS, WSL and Ubuntu users:

# Clone the repository
git clone https://github.com/srbhr/Resume-Matcher.git
cd Resume-Matcher

# Backend (Terminal 1)
cd apps/backend
cp .env.example .env        # Configure your AI provider
uv sync                      # Install dependencies
uv run app

# Frontend (Terminal 2)
cd apps/frontend
npm install
npm run dev

Open http://localhost:3000 and configure your AI provider in Settings.

Supported AI Providers

Provider Local/Cloud Notes
Ollama Local Free, runs on your machine
OpenAI Cloud GPT-5 Nano, GPT-4o
Anthropic Cloud Claude Haiku 4.5
Google Gemini Cloud Gemini 3 Flash
OpenRouter Cloud Access to multiple models
DeepSeek Cloud DeepSeek Chat

Docker Deployment

Official Docker images are published for linux/amd64 and linux/arm64 on:

Run on a single public port (3000) with API available at /api:

docker run --name resume-matcher \
  -p 3000:3000 \
  -v resume-data:/app/backend/data \
  ghcr.io/srbhr/resume-matcher:latest

Prefer pinning a version in production, for example ghcr.io/srbhr/resume-matcher:1.3.0 or ghcr.io/srbhr/resume-matcher:1.3.

Endpoints:

Using Ollama with Docker? Use http://host.docker.internal:11434 as the Ollama URL instead of localhost.

Tech Stack

Component Technology
Backend FastAPI, Python 3.13+, LiteLLM
Frontend Next.js 16, React 19, TypeScript
Database TinyDB (JSON file storage)
Styling Tailwind CSS 4, Swiss International Style
PDF Headless Chromium via Playwright

Join Us and Contribute

how to contribute

We welcome contributions from everyone! Whether you're a developer, designer, or just someone who wants to help out. All the contributors are listed in the about page on our website and on the GitHub Readme here.

Check out the roadmap if you would like to work on the features that are planned for the future. If you have any suggestions or feature requests, please feel free to open an issue on GitHub and discuss it on our Discord server.

Contributors

Contributors


Star History

Resume Matcher is a part of Vercel Open Source Program

Vercel OSS Program

Resume-Matcher (srbhr/Resume-Matcher)

Searching Database…

这是什么东西?Resume Matcher 是一个免费开源的 AI 工具,可以根据每一份职位申请定制你的简历,支持 Claude、ChatGPT、DeepSeek、Kimi、GLM、Gemma 等大语言模型,本地模型和远程模型都可以用。
那这是需要注册的网站,还是我自己在本地运行的东西?它是自托管应用,运行在你自己的电脑上:后端是 FastAPI,前端是 Next.js,在浏览器里打开使用。没有官方托管的在线服务。
我怎么把它跑起来?安装 Python 3.13+、Node.js 22+ 和 uv,然后按照 SETUP.md 里的 Quick Start 操作;项目附带 Docker Compose 方案,还有 Docker 里跑 Ollama 的方式,可以完全用本地 AI。
我需要花钱买 API 密钥吗,还是可以用本地模型?都可以。请求通过 LiteLLM 路由,支持 100 多种模型——可以用自己的 API 密钥调用 Claude、ChatGPT 这类远程模型,也可以通过 Ollama 使用本地模型。
安装上有什么麻烦的地方吗?我用的是 Windows。工具链要求很严格——Python 3.13+、Node 22+ 和最新版 uv——而且快速入门主要针对 macOS、WSL 和 Ubuntu,原生 Windows 用户会被引导去用 WSL。
我的简历数据会存到哪里?你的简历保存在你自己磁盘上的 TinyDB JSON 文件存储里,没有云端数据库。用本地模型时,任何数据都不会离开你的电脑;用远程服务时,对方也只能看到你发送给它的内容。
除了定制简历本身,它还能做什么?它会针对同一个职位描述生成配套的求职信,可以按需或通过设置自动生成基于你简历的面试准备材料,并把这两份文档导出为 PDF。
它是怎么判断我的简历和职位匹不匹配的?它会把你的简历和职位描述进行对比,给出匹配分数,并高亮关键词,给出具体的改进建议。
它支持导入和导出哪些文件格式?你以 PDF 或 DOCX 格式上传一份主简历,然后把定制后的简历和求职信导出为 PDF,渲染通过 Playwright 调用无头 Chromium 完成。
英语之外的语言能用吗?界面提供英语、西班牙语、中文、日语和巴西葡萄牙语,而且它可以用你偏好的语言来生成简历和求职信内容。
Creator
srbhr
Size
172.2 MB
Stars
28.8K
Age
6y
Commits · 90 Days