# Resume Matcher

> Resume Matcher is a free, open-source AI-powered tool that tailors your resume for specific job applications. Upload your master resume, paste a job description, and get an ATS-optimized version highlighting relevant experience and matching keywords—no fabrication, just smarter presentation.

## Quick Links

- Website: https://www.resumematcher.fyi
- Documentation: https://www.resumematcher.fyi/docs
- GitHub: https://github.com/srbhr/Resume-Matcher
- Blog: https://www.resumematcher.fyi/blog
- About: https://www.resumematcher.fyi/about

## Overview

Resume Matcher solves the exhausting cycle of manually rewriting resumes for every job application. Instead of spending hours customizing your resume or sending generic versions that get filtered by ATS systems, Resume Matcher uses AI to analyze job descriptions and automatically generate tailored versions of your resume.

The tool runs entirely locally with support for both cloud AI providers (OpenAI, Anthropic, Google Gemini, DeepSeek) and local models via Ollama for complete privacy. All data is stored in local JSON files—no external database required.

## Core Features

- **AI-Powered Tailoring**: Paste a job description and get an optimized resume in seconds
- **Resume Builder**: Visual editor with live preview for all sections (experience, education, projects, skills, etc.)
- **Multiple Templates**: Swiss Single Column and Swiss Two Column professional designs
- **PDF Export**: Clean, ATS-friendly PDFs matching the live preview
- **JD Match View**: Side-by-side comparison showing matched keywords and match percentage
- **Resume Enrichment**: AI asks targeted questions to generate additional content
- **Multi-Language**: Support for English, Spanish, Chinese, and Japanese
- **Privacy First**: Run completely locally with Ollama or use cloud providers

## How It Works

1. **Upload Master Resume**: Create a comprehensive resume with all your experience, skills, and projects
2. **Paste Job Description**: Copy the job posting you want to apply for
3. **AI Analysis**: The system extracts requirements and identifies matching skills
4. **Tailored Output**: Get an optimized version emphasizing relevant experience and keywords
5. **Export**: Download as PDF or continue editing in the visual builder

## Technical Stack

- **Frontend**: Astro + Tailwind CSS v4 (this marketing site)
- **Application**: Python 3.13+, Node.js 22+
- **AI Integration**: LiteLLM supporting multiple providers
- **Design System**: Swiss Brutalist with custom Tailwind tokens
- **Content**: Markdown-based blog and documentation

## Getting Started

**System Requirements:**
- Python 3.13+
- Node.js 22+
- 16-24 GB RAM (recommended for local Ollama models)
- Modern browser

**Quick Install:**
```bash
git clone https://github.com/srbhr/Resume-Matcher.git
cd Resume-Matcher
pip install -r requirements.txt
npm install
```

**Docker Install:**
```bash
docker compose up
```

See full installation guide: https://www.resumematcher.fyi/docs/installation

## AI Providers Supported

- OpenAI (GPT-5 series)
- Anthropic (Claude family)
- Google Gemini (2.5 & 3 family)
- OpenRouter
- DeepSeek
- Ollama (local, privacy-first)

Configure your preferred provider in Settings after installation.

## Use Cases

- **Job Seekers**: Tailor resumes quickly for multiple applications
- **Career Coaches**: Help clients optimize their resumes
- **Recruiters**: Understand how ATS systems parse resumes
- **Students**: Create targeted resumes for internships and first jobs
- **Career Changers**: Highlight transferable skills for new industries

## Documentation Structure

All documentation is available at https://www.resumematcher.fyi/docs:

- **Getting Started**: Introduction and workflow overview
- **Installation**: Local setup in 5 minutes
- **Docker Installation**: One-command containerized deployment
- **Docker + Ollama**: Completely local, privacy-first setup
- **Features**: Comprehensive feature documentation
- **PDF Templates**: Template customization guide
- **Internationalization**: Multi-language support
- **Contributing**: How to contribute to the project

## Blog Topics

Recent posts at https://www.resumematcher.fyi/blog:

- AI in recruitment trends
- Career longevity in tech
- Open source summer programs
- Resume optimization best practices

## Open Source

Resume Matcher is MIT licensed and maintained by Saurabh Rai (@srbhrai) with contributions from developers worldwide. We welcome contributions, bug reports, and feature requests.

**Contributing:**
- Fork the repository
- Create a feature branch
- Submit a pull request
- Join our community discussions

See contributing guide: https://www.resumematcher.fyi/docs/contributing

## Project Structure

This marketing/documentation site:
```
src/
├── pages/          # Routes (home, about, blog, docs)
├── components/     # Reusable UI components
├── content/        # Blog posts and documentation (Markdown)
├── layouts/        # Page layout shells
└── styles/         # Tailwind v4 theme tokens
```

## Community

- GitHub Discussions: https://github.com/srbhr/Resume-Matcher/discussions
- Twitter: @srbhrai
- Sponsors: https://github.com/sponsors/srbhr

## Design Philosophy

The marketing site follows Swiss Brutalist design principles:

- No rounded corners (`rounded-none` everywhere)
- Hard shadows without blur
- Strict geometric grid
- Corner decorative blocks for depth
- Monochrome with accent colors (Hyper Blue #1D4ED8)
- Typography: Serif for display, sans for body, mono for labels

## AI Agent Support

This site provides **direct markdown access** for optimal AI parsing:

- Home page: `https://www.resumematcher.fyi/index.md`
- Append `.md` to any docs or blog URL to get raw markdown
- Example: `https://www.resumematcher.fyi/docs/getting-started.md`
- 10x token reduction compared to HTML

**All content available as markdown:**
- /index.md (project overview with team & contributors)
- /docs/getting-started.md
- /docs/installation.md
- /docs/features.md
- /blog/ai-in-recruitment.md
- And more...

See [AI-AGENT-SUPPORT.md](https://github.com/srbhr/Resume-Matcher/blob/main/AI-AGENT-SUPPORT.md) for full details.

## Keywords

resume matcher, ATS scanner, resume checker, job application, resume optimization, open source, AI resume, keyword matching, job search, career tools, resume builder, ATS-friendly, resume tailoring, job description matching, resume parser

---

This file was created following the llms.txt standard to help Large Language Models better understand and index Resume Matcher's content. For the most current information, visit https://www.resumematcher.fyi

**For AI Agents:** All documentation and blog pages serve markdown when requested with `Accept: text/markdown` or `Accept: text/plain` headers.

Last updated: January 2, 2026