[!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.

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

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

Follow us on LinkedIn for updates.

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

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.

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

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

Creators' Note

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:

• Website: https://srbhr.com
• Linkedin: https://www.linkedin.com/in/srbhr/
• Twitter: https://twitter.com/srbhr_r
• GitHub: https://github.com/srbhr

Key Features

Core Features

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

Resume Builder

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

You can:

• Modify suggested content
• Add/remove sections
• Rearrange sections via drag-and-drop
• Choose from multiple resume templates

Cover Letter Generator

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

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.

PDF Export

Export your tailored resume and cover letter in PDF.

Templates

Internationalization

• Multi-Language UI: Interface available in English, Spanish, Chinese, Japanese, and Portuguese (Brazilian)
• Multi-Language Content: Generate resumes and cover letters in your preferred language

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.

• AI Canvas for crafting impactful, metric-driven resume content
• Email template generator for job applications
• Multi-job description optimization

How to Install

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

Prerequisites

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

Docker Deployment

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

• ghcr.io/srbhr/resume-matcher
• srbhr/resume-matcher

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:

• App: http://localhost:3000
• API health check: http://localhost:3000/api/v1/health
• API docs: http://localhost:3000/docs

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

Tech Stack

Join Us and 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

Star History

Resume Matcher is a part of Vercel Open Source Program