Resume-Matcher - GitLite

KO | EN

gitlite — search

#llm #go #machine-learning #linux #macos #java #windows #awesome #cli #vue #pytorch #security #openai #ios

Resume-Matcher

(★ 28,204)

100개 이상의 LLM을 지원하며, 이력서, PDF, 커버 레터 등을 로컬에서 구축할 수 있는 최고의 AI 도구입니다.

파일 탐색기

최종 버전 다운로드 (.zip)

- CLAUDE.md
- settings.json
- pre-push
- README.md
- - bug_report.yml
  - config.yml
  - custom.yml
  - feature_request.yml
- - docker-publish.yml
- CODE_OF_CONDUCT.md
- CONTRIBUTING.md
- FUNDING.yml
- ISSUE_TEMPLATE.md
- PULL_REQUEST_TEMPLATE.md
- SECURITY.md
- - .env.example
  - .env.sample
  - .gitignore
  - .python-version
  - CLAUDE.md
  - pyproject.toml
  - requirements.txt
- - .env.sample
  - .gitignore
  - .prettierrc
  - CLAUDE.md
  - eslint.config.mjs
  - next.config.ts
  - package-lock.json
  - package.json
  - postcss.config.mjs
  - tsconfig.json
  - vitest.config.ts
  - vitest.setup.ts
- - modern-single-column.jpg
  - modern-single-column.pdf
  - modern-two-column.jpg
  - modern-two-column.pdf
  - single-column.jpg
  - single-column.pdf
  - two-column.jpg
  - two-column.pdf
- contributors.png
- cover_letter.png
- cover_letter_es.png
- cover_letter_ja.png
- cover_letter_zh-CN.png
- creators_note.png
- favicon.ico
- features.png
- header.png
- how_to_contribute.png
- how_to_install_resumematcher.png
- installing_resume_matcher.png
- keyword_highlighter.png
- keyword_highlighter_ja.png
- keyword_highlighter_zh-CN.png
- logo.svg
- master_resume_view.png
- page_2.png
- Resume_Matcher_Demo.gif
- Resume_Matcher_Demo_2.gif
- resume_matcher_discord.png
- resume_matcher_features.png
- resume_matcher_linkedin.png
- Resume_Matcher_Video.mp4
- sponsors.png
- Star Resume Matcher.png
- star_resume_matcher.png
- step_1.png
- step_2.png
- step_2_zh-CN.png
- step_3.png
- step_5.png
- step_5_ja.png
- step_5_zh-CN.png
- supporting_resume_matcher.png
- start.sh
- - coding-standards.md
  - llm-integration.md
  - quickstart.md
  - README.md
  - scope-and-principles.md
  - testing-strategy.md
  - workflow.md
- - README.md
- check_locale_parity.py
.dockerignore
.gitignore
.impeccable.md
docker-compose.yml
Dockerfile
LICENSE
README.es.md
README.ja.md
README.md
README.zh-CN.md
SETUP.es.md
SETUP.ja.md
SETUP.md
SETUP.zh-CN.md

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

<div align="center">

[![Resume Matcher](https://raw.githubusercontent.com/srbhr/Resume-Matcher/main/assets/header.png)](https://www.resumematcher.fyi)

# Resume Matcher

[𝙹𝚘𝚒𝚗 𝙳𝚒𝚜𝚌𝚘𝚛𝚍](https://dsc.gg/resume-matcher) ✦ [𝚆𝚎𝚋𝚜𝚒𝚝𝚎](https://resumematcher.fyi) ✦ [𝙷𝚘𝚠 𝚝𝚘 𝙸𝚗𝚜𝚝𝚊𝚕𝚕](https://resumematcher.fyi/docs/installation) ✦ [𝙲𝚘𝚗𝚝𝚛𝚒𝚋𝚞𝚝𝚘𝚛𝚜](#contributors) ✦ [𝚂𝚙𝚘𝚗𝚜𝚘𝚛](#sponsors) ✦ [𝚃𝚠𝚒𝚝𝚝𝚎𝚛/𝚇](https://twitter.com/srbhrai) ✦ [𝙻𝚒𝚗𝚔𝚎𝚍𝙸𝚗](https://www.linkedin.com/company/resume-matcher/) ✦ [𝙲𝚛𝚎𝚊𝚝𝚘𝚛](https://srbhr.com)

**English** | [Español](README.es.md) | [简体中文](README.zh-CN.md) | [日本語](README.ja.md)

Claude, ChatGPT, DeepSeek, Kimi, GLM, Gemma 및 기타 LLM을 사용하여 각 채용 공고에 맞춘 맞춤형 이력서를 작성하는 AI 도구입니다. 로컬 및 원격 LLM을 모두 지원합니다.

![Resume Matcher Demo](https://raw.githubusercontent.com/srbhr/Resume-Matcher/main/assets/Resume_Matcher_Demo_2.gif)

</div>

<br>

<div align="center">

![Stars](https://img.shields.io/github/stars/srbhr/Resume-Matcher?labelColor=F0F0E8&style=for-the-badge&color=1d4ed8)
![Apache 2.0](https://img.shields.io/github/license/srbhr/Resume-Matcher?labelColor=F0F0E8&style=for-the-badge&color=1d4ed8) ![Forks](https://img.shields.io/github/forks/srbhr/Resume-Matcher?labelColor=F0F0E8&style=for-the-badge&color=1d4ed8) ![version](https://img.shields.io/badge/Version-1.2%20Nightvision%20-FFF?labelColor=F0F0E8&style=for-the-badge&color=1d4ed8)

[![Discord](https://img.shields.io/discord/1122069176962531400?labelColor=F0F0E8&logo=discord&logoColor=1d4ed8&style=for-the-badge&color=1d4ed8)](https://dsc.gg/resume-matcher) [![Website](https://img.shields.io/badge/website-Resume%20Matcher-FFF?labelColor=F0F0E8&style=for-the-badge&color=1d4ed8)](https://resumematcher.fyi) [![LinkedIn](https://img.shields.io/badge/LinkedIn-Resume%20Matcher-FFF?labelColor=F0F0E8&logo=LinkedIn&style=for-the-badge&color=1d4ed8)](https://www.linkedin.com/company/resume-matcher/)

<a href="https://trendshift.io/repositories/565" target="_blank"><img src="https://trendshift.io/api/badge/repositories/565" alt="srbhr%2FResume-Matcher | Trendshift" style="width: 250px; height: 55px;" width="250" height="55"/></a>

![Vercel OSS Program](https://vercel.com/oss/program-badge.svg)

</div>

> \[!IMPORTANT]
>
> 이 프로젝트는 여러분의 도움과 지원이 필요합니다. 소액이라도 후원해 주신다면 Resume Matcher를 계속해서 개발하고 개선하는 데 큰 도움이 됩니다.

<div align="center">

[![Sponsor on GitHub](https://img.shields.io/github/sponsors/srbhr?style=for-the-badge&label=Sponsor&color=1d4ed8&labelColor=F0F0E8&logo=github&logoColor=black)](https://github.com/sponsors/srbhr) [![Buy Me a Coffee](https://img.shields.io/badge/Buy%20Me%20a%20Coffee-ffdd00?style=for-the-badge&logo=buy-me-a-coffee&color=1d4ed8&labelColor=F0F0E8&logoColor=black)](https://www.buymeacoffee.com/srbhr)

**기업 후원을 고려하시나요?** 27,000명 이상의 개발자에게 귀사의 로고를 노출하세요 → **[스폰서 되기 ↓](#sponsors)**

</div>

## Getting Started

Resume Matcher는 각 채용 공고에 맞게 최적화할 수 있는 마스터 이력서를 생성함으로써 작동합니다. 설치 방법은 여기를 참조하세요: [How to Install](#how-to-install)

### 작동 방식

1. **업로드**: 마스터 이력서(PDF 또는 DOCX)를 업로드합니다.
2. **붙여넣기**: 타겟팅하는 직무 설명(Job Description)을 붙여넣습니다.
3. **검토**: AI가 생성한 개선 사항과 맞춤형 콘텐츠를 검토합니다.
4. **커버 레터**: 커버 레터를 작성하고, 필요한 경우 입사 지원을 위한 면접 준비를 진행합니다.
5. **사용자 정의**: 본인의 스타일에 맞게 레이아웃과 섹션을 조정합니다.
6. **내보내기**: 선호하는 템플릿을 사용하여 전문적인 PDF로 내보냅니다.

### 커뮤니티 연결

[![Discord](https://raw.githubusercontent.com/srbhr/Resume-Matcher/main/assets/resume_matcher_discord.png)](https://dsc.gg/resume-matcher)

토론, 기능 요청 및 커뮤니티 지원을 위해 [Discord](https://dsc.gg/resume-matcher)에 참여하세요.

[![LinkedIn](https://raw.githubusercontent.com/srbhr/Resume-Matcher/main/assets/resume_matcher_linkedin.png)](https://www.linkedin.com/company/resume-matcher/)

최신 업데이트 소식을 위해 [LinkedIn](https://www.linkedin.com/company/resume-matcher/)을 팔로우하세요.

![Star Resume Matcher](https://raw.githubusercontent.com/srbhr/Resume-Matcher/main/assets/star_resume_matcher.png)

저장소에 Star를 눌러 개발을 지원하고 새로운 릴리스 알림을 받으세요.

## Sponsors

![sponsors](https://raw.githubusercontent.com/srbhr/Resume-Matcher/main/assets/sponsors.png)

Resume Matcher는 무료 오픈 소스 프로젝트이며, 후원자와 지지자들의 도움으로 운영됩니다. 도움이 되셨다면 개발 지원을 고려해 주세요.

### Resume Matcher 후원 기업

기업 티어로 후원하시면 **귀사의 로고 + 링크 + 설명이 이곳에 게시**됩니다. [Trendshift](https://trendshift.io/repositories/565) 및 [Vercel OSS Program](https://vercel.com/oss)에 소개되어 **27,000개 이상의 Star와 4,900개 이상의 Fork**를 보유한 커뮤니티에 노출됩니다.

| Sponsor | Description |
|---------|-------------|
| [Apideck](https://apideck.com?utm_source=resumematcher&utm_medium=github&utm_campaign=sponsors) | 앱을 200개 이상의 SaaS 플랫폼(회계, HRIS, CRM, 파일 저장소)에 연결하는 단일 API입니다. 통합 기능을 50번 반복할 필요 없이 한 번만 구축하세요. 🌐 [apideck.com](https://apideck.com?utm_source=resumematcher&utm_medium=github&utm_campaign=sponsors) |
| [Vercel](https://vercel.com?utm_source=resumematcher&utm_medium=github&utm_campaign=sponsors) | Resume Matcher는 Vercel OSS // Summer 2025 프로그램의 일부입니다. 🌐 [vercel.com](https://vercel.com?utm_source=resumematcher&utm_medium=github&utm_campaign=sponsors) |
| [Cubic.dev](https://cubic.dev?utm_source=resumematcher&utm_medium=github&utm_campaign=sponsors) | Cubic은 Resume Matcher에 PR 리뷰를 제공합니다. 🌐 [cubic.dev](https://cubic.dev?utm_source=resumematcher&utm_medium=github&utm_campaign=sponsors) |
| [Kilo Code](https://kilo.ai?utm_source=resumematcher&utm_medium=github&utm_campaign=sponsors) | Kilo Code는 Resume Matcher에 AI 코드 리뷰와 코딩 크레딧을 제공합니다. 🌐 [kilo.ai](https://kilo.ai?utm_source=resumematcher&utm_medium=github&utm_campaign=sponsors) |
| [ZanReal](https://zanreal.com/?utm_source=resumematcher&utm_medium=github&utm_campaign=sponsors) | ZanReal은 전략, UX부터 DevOps까지 확장 가능한 클라우드 솔루션을 구축하여 팀이 더 빠르게 배포하고 아이디어를 실제 제품으로 구현하도록 돕는 AI 기반 개발 회사입니다. 🌐 [zanreal.com](https://zanreal.com/?utm_source=resumematcher&utm_medium=github&utm_campaign=sponsors) |
| **✦ Your company here** | 27,000명 이상의 개발자와 4,900개의 Fork에 도달하세요. **[스폰서 되기 →](https://github.com/sponsors/srbhr)** |

티어 및 자세한 내용은 [Sponsorship Guide](https://resumematcher.fyi/docs/sponsoring)를 읽어보세요. 후원자는 README와 웹사이트에서 특별한 감사 인사를 받게 됩니다.

<a id="support-the-development-by-donating"></a>

### 개인 후원

![donate](https://raw.githubusercontent.com/srbhr/Resume-Matcher/main/assets/supporting_resume_matcher.png)

작은 후원 하나하나가 Resume Matcher를 무료로 유지하고 새로운 기능을 개발하는 데 큰 힘이 됩니다. 후원해 주신 분들은 README와 웹사이트에 기재됩니다.

| Platform  | Link                                   |
|-----------|----------------------------------------|
| GitHub    | [![GitHub Sponsors](https://img.shields.io/github/sponsors/srbhr?style=for-the-badge&color=1d4ed8&labelColor=F0F0E8&logo=github&logoColor=black)](https://github.com/sponsors/srbhr) |
| Buy Me a Coffee | [![BuyMeACoffee](https://img.shields.io/badge/Buy%20Me%20a%20Coffee-ffdd00?style=for-the-badge&logo=buy-me-a-coffee&color=1d4ed8&labelColor=F0F0E8&logoColor=black)](https://www.buymeacoffee.com/srbhr) |

## Creators' Note

[![srbhr](https://raw.githubusercontent.com/srbhr/Resume-Matcher/main/assets/creators_note.png)](https://srbhr.com)

Resume Matcher를 확인해 주셔서 감사합니다. 연결, 협업 또는 간단한 인사를 나누고 싶으시다면 언제든지 연락해 주세요!
~ **Saurabh Rai** ✨

다음 채널에서 저를 팔로우하실 수 있습니다:

- Website: [https://srbhr.com](https://srbhr.com)
- Linkedin: [https://www.linkedin.com/in/srbhr/](https://www.linkedin.com/in/srbhr/)
- Twitter: [https://twitter.com/srbhrai](https://twitter.com/srbhrai)
- GitHub: [https://github.com/srbhr](https://github.com/srbhr)

## Key Features

![resume_matcher_features](https://raw.githubusercontent.com/srbhr/Resume-Matcher/main/assets/features.png)

### 핵심 기능

**마스터 이력서(Master Resume)**: 기존 이력서를 바탕으로 활용 가능한 종합적인 마스터 이력서를 생성합니다.

![Job Description Input](https://raw.githubusercontent.com/srbhr/Resume-Matcher/main/assets/step_2.png)

### 이력서 빌더 (Resume Builder)

![Resume Builder](https://raw.githubusercontent.com/srbhr/Resume-Matcher/main/assets/step_5.png)

직무 설명을 붙여넣으면 해당 역할에 특화된 AI 기반 맞춤형 이력서를 생성합니다.

가능한 작업:

- 추천된 콘텐츠 수정
- 섹션 추가/제거
- 드래그 앤 드롭을 통한 섹션 재배치
- 다양한 이력서 템플릿 중 선택

### 커버 레터 생성기 (Cover Letter Generator)

직무 설명과 이력서를 기반으로 맞춤형 커버 레터를 생성합니다.

![Cover Letter](https://raw.githubusercontent.com/srbhr/Resume-Matcher/main/assets/cover_letter.png)

### 면접 준비 (Interview Preparation)

저장된 맞춤형 이력서를 기반으로 구조화된 면접 준비 자료를 생성합니다. 빌더의 Interview Prep 탭을 사용하여 필요할 때 생성하거나, 설정에서 자동 생성 기능을 활성화할 수 있습니다.

### 이력서 점수 산정 및 키워드 하이라이팅 (Resume Scoring & Keyword Highlighting)

매칭 점수, 키워드 하이라이팅 및 개선 제안을 통해 직무 설명 대비 이력서를 분석합니다.

![Resume Scoring and Keyword Highlight](https://raw.githubusercontent.com/srbhr/Resume-Matcher/main/assets/keyword_highlighter.png)

### PDF 내보내기 (PDF Export)

맞춤형 이력서와 커버 레터를 PDF로 내보냅니다.

### 템플릿 (Templates)

| Template Name | Preview | Description |
|---------------|---------|-------------|
| **Classic Single Column** | ![Classic Template](https://raw.githubusercontent.com/srbhr/Resume-Matcher/main/assets/pdf-templates/single-column.jpg) | 대부분의 산업군에 적합한 전통적이고 깔끔한 레이아웃입니다. [𝐕𝐢𝐞𝐰 𝐏𝐃𝐅](assets/pdf-templates/single-column.pdf) |
| **Modern Single Column** | ![Modern Template](https://raw.githubusercontent.com/srbhr/Resume-Matcher/main/assets/pdf-templates/modern-single-column.jpg) | 가독성과 심미성에 중점을 둔 현대적인 디자인입니다. [𝐕𝐢𝐞𝐰 𝐏𝐃𝐅](assets/pdf-templates/modern-single-column.pdf)|
| **Classic Two Column** | ![Classic Two Column Template](https://raw.githubusercontent.com/srbhr/Resume-Matcher/main/assets/pdf-templates/two-column.jpg) | 명확성을 위해 섹션을 분리한 구조적 레이아웃입니다. [𝐕𝐢𝐞𝐰 𝐏𝐃𝐅](assets/pdf-templates/two-column.pdf)|
| **Modern Two Column** | ![Modern Two Column Template](https://raw.githubusercontent.com/srbhr/Resume-Matcher/main/assets/pdf-templates/modern-two-column.jpg) | 더 나은 조직화를 위해 두 개의 열을 사용하는 세련된 디자인입니다. [𝐕𝐢𝐞𝐰 𝐏𝐃𝐅](assets/pdf-templates/modern-two-column.pdf)|

### 국제화 (Internationalization)

- **다국어 UI**: 영어, 스페인어, 중국어, 일본어, 포르투갈어(브라질) 인터페이스를 지원합니다.
- **다국어 콘텐츠**: 선호하는 언어로 이력서와 커버 레터를 생성할 수 있습니다.

### 로드맵 (Roadmap)

제안 사항이나 기능 요청이 있으시면 GitHub에 issue를 생성하거나 [Discord](https://dsc.gg/resume-matcher) 서버에서 논의해 주세요.

- 영향력 있고 수치 중심인 이력서 콘텐츠 작성을 위한 AI Canvas
- 입사 지원용 이메일 템플릿 생성기
- 다중 직무 설명 최적화

<a id="how-to-install"></a>

## How to Install

![Installation](https://raw.githubusercontent.com/srbhr/Resume-Matcher/main/assets/how_to_install_resumematcher.png)

상세 설정 방법은 **[SETUP.md](SETUP.md)** (영어) 또는 [Español](SETUP.es.md), [简体中文](SETUP.zh-CN.md), [日本語](SETUP.ja.md)를 참조하세요.

### Prerequisites

| Tool | Version | Installation |
|------|---------|--------------|
| Python | 3.13+ | [python.org](https://python.org) |
| Node.js | 22+ | [nodejs.org](https://nodejs.org) |
| uv | Latest | [astral.sh/uv](https://docs.astral.sh/uv/getting-started/installation/) |

### Quick Start

MacOS, WSL 및 Ubuntu 사용자에게 가장 빠른 방법:

```bash
# 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
```

**<http://localhost:3000>**을 열고 설정(Settings)에서 AI 제공자를 구성하세요.

### Supported AI Providers

| Provider | Local/Cloud | Notes |
|----------|-------------|-------|
| **Ollama** | Local | 무료, 사용자 로컬 머신에서 실행 |
| **OpenAI** | Cloud | GPT-5 Nano, GPT-4o |
| **Anthropic** | Cloud | Claude Haiku 4.5 |
| **Google Gemini** | Cloud | Gemini 3 Flash |
| **OpenRouter** | Cloud | 여러 모델에 액세스 가능 |
| **DeepSeek** | Cloud | DeepSeek Chat |

### Docker Deployment

공식 Docker 이미지는 `linux/amd64` 및 `linux/arm64`용으로 다음 경로에 게시됩니다:

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

단일 공용 포트(`3000`)에서 실행하며, API는 `/api`에서 사용할 수 있습니다:

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

운영 환경에서는 `ghcr.io/srbhr/resume-matcher:1.2.0` 또는 `ghcr.io/srbhr/resume-matcher:1.2`와 같이 버전을 고정하는 것을 권장합니다.

엔드포인트:

- App: <http://localhost:3000>
- API health check: <http://localhost:3000/api/v1/health>
- API docs: <http://localhost:3000/docs>

> **Docker에서 Ollama를 사용하시나요?** `localhost` 대신 `http://host.docker.internal:11434`를 Ollama URL로 사용하세요.

### 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](https://raw.githubusercontent.com/srbhr/Resume-Matcher/main/assets/how_to_contribute.png)

모든 분의 기여를 환영합니다! 개발자, 디자이너, 혹은 단순히 도움을 주고 싶으신 분 모두 가능합니다. 모든 기여자분들은 저희 웹사이트의 [about page](https://resumematcher.fyi/about)와 여기 GitHub Readme에 기재됩니다.

향후 계획된 기능에 참여하고 싶으시다면 로드맵을 확인해 주세요. 제안 사항이나 기능 요청이 있으시면 언제든지 GitHub에 issue를 생성하고 [Discord](https://dsc.gg/resume-matcher) 서버에서 논의해 주세요.

<a id="contributors"></a>

## Contributors

![Contributors](https://raw.githubusercontent.com/srbhr/Resume-Matcher/main/assets/contributors.png)

<a href="https://github.com/srbhr/Resume-Matcher/graphs/contributors">
  <img src="https://contrib.rocks/image?repo=srbhr/Resume-Matcher" />
</a>

<br/>

<details>
  <summary><kbd>Star History</kbd></summary>
  <picture>
    <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=srbhr/resume-matcher&theme=dark&type=Date">
    <img width="100%" src="https://api.star-history.com/svg?repos=srbhr/resume-matcher&theme=dark&type=Date">
  </picture>
</details>

## Resume Matcher is a part of [Vercel Open Source Program](https://vercel.com/oss)

![Vercel OSS Program](https://vercel.com/oss/program-badge.svg)