MCPcopy Index your code
hub / github.com/srbhr/Resume-Matcher

github.com/srbhr/Resume-Matcher @1.2.0 sqlite

repository ↗ · DeepWiki ↗ · release 1.2.0 ↗
1,126 symbols 3,031 edges 150 files 341 documented · 30% 19 cross-repo links
README

Resume Matcher

Resume Matcher

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

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

求人ごとに最適化した履歴書を、AI の提案で作成できます。Ollama を使ってローカルで動かすことも、API 経由でお気に入りの LLM プロバイダに接続することも可能です。

Resume Matcher Demo

Stars Apache 2.0 Forks version

Discord Website LinkedIn

srbhr%2FResume-Matcher | Trendshift

Vercel OSS Program

[!IMPORTANT]

本プロジェクトはアクティブに開発中です。新機能は継続的に追加され、コミュニティからのコントリビューションも歓迎しています。提案や機能要望があれば、GitHub に Issue を立てるか、Discord でご相談ください。

はじめに

Resume Matcher は、まず「マスター履歴書」を作り、それを各求人応募向けに調整する形で動作します。インストール手順は:インストール方法

仕組み

  1. アップロード:マスター履歴書(PDF / DOCX)
  2. 貼り付け:応募先の求人票(Job Description)
  3. 確認:AI が生成した改善案と最適化内容
  4. 生成:求人向けのカバーレターとメール文面
  5. 調整:レイアウトやセクションを好みに合わせてカスタマイズ
  6. 書き出し:好みのテンプレートで PDF を出力

コミュニティ

Discord

ディスカッション、要望、サポートは Discord へ。

LinkedIn

最新情報は LinkedIn でも発信しています。

Star Resume Matcher

Star を付けていただけると開発の励みになります(リリース通知も受け取れます)。

スポンサー

sponsors

スポンサーの皆さまに感謝します。Resume Matcher が役立ったと感じたら、GitHub Sponsors での支援をご検討ください。継続的な開発と改善につながります。

Sponsor Description
APIDECK アプリを200以上のSaaSプラットフォーム(会計、HRIS、CRM、ファイルストレージ)に接続する単一のAPI。50回ではなく、1回の構築で統合を実現します。 🌐 apideck.com
Vercel Resume Matcher は Vercel OSS // Summer 2025 プログラムの一部です 🌐 vercel.com
Cubic.dev Cubic は Resume Matcher に PR レビューを提供しています 🌐 cubic.dev
Kilo Code Kilo Code は Resume Matcher に AI コードレビューとコーディングクレジットを提供しています 🌐 kilo.ai

Resume Matcher を支援する

donate

スポンサーシップがプロジェクトにどのように役立つかについての詳細は、Sponsorship Guide をご覧ください。ReadME およびウェブサイトにて特別に感謝の意を表します。

プラットフォーム リンク
GitHub GitHub Sponsors
Buy Me a Coffee BuyMeACoffee

制作者ノート

Resume Matcher をご覧いただきありがとうございます。つながりやコラボレーション、あるいは挨拶だけでも、お気軽にご連絡ください! ~ Saurabh Rai

以下でフォローできます:

主な機能

resume_matcher_features

コア機能

マスター履歴書(Master Resume):既存の履歴書から、再利用できる包括的なマスター履歴書を作成します。

Job Description Input

履歴書ビルダー

Resume Builder

求人票を貼り付けると、その職種に合わせた AI 提案の履歴書を生成します。

できること:

  • 提案内容の編集
  • セクションの追加/削除
  • ドラッグ&ドロップで順序変更
  • 複数テンプレートから選択

カバーレター&メール生成

求人票と履歴書に基づき、カスタマイズされたカバーレターとメール文面を生成します。

Cover Letter

履歴書スコアリング(開発中)

履歴書と求人票を比較して、マッチスコアと改善提案を出す機能を開発中です。

Resume Scoring and Keyword Highlight

PDF 出力

最適化した履歴書とカバーレターを PDF として出力できます。

テンプレート

テンプレート名 プレビュー 説明
クラシック(1 カラム) Classic Template 伝統的でクリーンなレイアウト。多くの業種に適しています。PDF を見る
モダン(1 カラム) Modern Template 可読性と美しさを重視した現代的なデザイン。PDF を見る
クラシック(2 カラム) Classic Two Column Template セクションを分けて見やすく整理します。PDF を見る
モダン(2 カラム) Modern Two Column Template 2 カラムを活用して情報をより整理します。PDF を見る

国際化

  • 多言語 UI:英語・スペイン語・中国語・日本語に対応
  • 多言語コンテンツ:希望言語で履歴書とカバーレターを生成

ロードマップ

提案や機能要望があれば、GitHub に Issue を立てるか、Discord でご相談ください。

  • キーワードの視覚的ハイライト
  • 定量的でインパクトのある内容を作る AI Canvas
  • 複数求人票の同時最適化

インストール方法

Installation

詳細なセットアップ手順は SETUP.ja.md を参照してください(English / Español / 简体中文 も利用できます)。

前提条件

ツール バージョン インストール
Python 3.13+ python.org
Node.js 22+ nodejs.org
uv 最新 astral.sh/uv

クイックスタート

MacOS / WSL / Ubuntu で最も手早い手順:

# リポジトリをクローン
git clone https://github.com/srbhr/Resume-Matcher.git
cd Resume-Matcher

# バックエンド(ターミナル 1)
cd apps/backend
cp .env.example .env        # AI プロバイダを設定
uv sync                      # 依存関係をインストール
uv run uvicorn app.main:app --reload --port 8000

# フロントエンド(ターミナル 2)
cd apps/frontend
npm install
npm run dev

http://localhost:3000 を開き、Settings で AI プロバイダを設定してください。

対応 AI プロバイダ

プロバイダ ローカル/クラウド 備考
Ollama ローカル 無料。手元のマシンで動作
OpenAI クラウド GPT-4o、GPT-4o-mini
Anthropic クラウド Claude 3.5 Sonnet
Google Gemini クラウド Gemini 1.5 Flash/Pro
OpenRouter クラウド 複数モデルへアクセス
DeepSeek クラウド DeepSeek Chat

Docker デプロイ

docker pull srbhr/resume-matcher:latest

docker run srbhr/resume-matcher:latest

Docker で Ollama を使う場合:Ollama の URL は localhost ではなく http://host.docker.internal:11434 を指定します。

技術スタック

コンポーネント 技術
バックエンド FastAPI、Python 3.13+、LiteLLM
フロントエンド Next.js 15、React 19、TypeScript
データベース TinyDB(JSON ファイル保存)
スタイリング Tailwind CSS 4、Swiss International Style
PDF Playwright による Headless Chromium

参加・コントリビュート

how to contribute

どなたでもコントリビュート歓迎です。開発者・デザイナー・ユーザーを問わず、協力してくれる方を募集しています。コントリビューター一覧は、公式サイトの about ページ と GitHub README に掲載されています。

ロードマップも参考にしてください。提案や機能要望があれば、GitHub で Issue を作成し、Discord でも議論できます。

コントリビューター

Contributors

Star の推移

<img width="100%" src="https://api.star-history.com/svg?repos=srbhr/resume-matcher&theme=dark&type=Date">

Resume Matcher は Vercel Open Source Program の一部です

Vercel OSS Program

Extension points exported contracts — how you extend this code

DialogContextValue (Interface)
* Swiss International Style Dialog Component * * Native implementation without external dependencies. * - Square corn
apps/frontend/components/ui/dialog.tsx
ItemRowProps (Interface)
* ItemRow - Individual selectable item row
apps/frontend/components/builder/regenerate-dialog.tsx
AddSectionButtonProps (Interface)
* AddSectionButton Component * * Button that triggers the AddSectionDialog.
apps/frontend/components/builder/add-section-dialog.tsx
MarginSliderProps (Interface)
* Margin Slider Component * * Range input for margin values (5-25mm)
apps/frontend/components/builder/formatting-controls.tsx
SpacingSelectorProps (Interface)
* Spacing Selector Component * * Button group for selecting spacing levels (1-5)
apps/frontend/components/builder/formatting-controls.tsx

Core symbols most depended-on inside this repo

t
called by 724
apps/frontend/app/print/resumes/[id]/page.tsx
sanitizeFilename
called by 62
apps/frontend/lib/utils/download.ts
useTranslations
called by 54
apps/frontend/lib/i18n/translations.ts
cn
called by 46
apps/frontend/lib/utils.ts
apply_diffs
called by 33
apps/backend/app/services/improver.py
apiFetch
called by 25
apps/frontend/lib/api/client.ts
get_resume
called by 20
apps/backend/app/database.py
verify_diff_result
called by 19
apps/backend/app/services/improver.py

Shape

Function 605
Method 171
Interface 150
Class 115
Route 85

Languages

Python51%
TypeScript49%

Modules by API surface

apps/backend/app/schemas/models.py63 symbols
apps/backend/app/routers/resumes.py51 symbols
apps/backend/tests/unit/test_apply_diffs.py39 symbols
apps/backend/app/routers/config.py35 symbols
apps/backend/tests/service/test_improver.py34 symbols
apps/frontend/lib/api/config.ts33 symbols
apps/backend/tests/integration/test_resume_api.py33 symbols
apps/backend/tests/unit/test_refiner.py29 symbols
apps/backend/app/services/improver.py28 symbols
apps/backend/app/llm.py27 symbols
apps/frontend/lib/api/resume.ts26 symbols
apps/backend/tests/integration/test_config_api.py26 symbols

Dependencies from manifests, versioned

@dnd-kit/core6.3.1 · 1×
@dnd-kit/sortable10.0.0 · 1×
@dnd-kit/utilities3.2.2 · 1×
@testing-library/react16.3.2 · 1×
@tiptap/extension-link3.20.0 · 1×
@tiptap/extension-underline3.20.0 · 1×
@tiptap/react3.20.0 · 1×
@tiptap/starter-kit3.20.0 · 1×
@types/node25 · 1×
@types/react19 · 1×

For agents

$ claude mcp add Resume-Matcher \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact