Back to Resume Matcher

Resume Matcher

README.ja.md

1.2.013.3 KB
Original Source
<div align="center">

Resume Matcher

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

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

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

</div> <div align="center">

<a href="https://trendshift.io/repositories/565" target="_blank"></a>

</div>

[!IMPORTANT]

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

はじめに

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

仕組み

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

コミュニティ

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

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

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

スポンサー

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

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

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

Resume Matcher を支援する

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

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

制作者ノート

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

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

主な機能

コア機能

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

履歴書ビルダー

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

できること:

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

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

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

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

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

PDF 出力

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

テンプレート

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

国際化

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

ロードマップ

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

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

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

インストール方法

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

前提条件

ツールバージョンインストール
Python3.13+python.org
Node.js22+nodejs.org
uv最新astral.sh/uv

クイックスタート

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

bash
# リポジトリをクローン
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 デプロイ

bash
docker pull srbhr/resume-matcher:latest

docker run srbhr/resume-matcher:latest
<!-- 注:Docker ドキュメントは準備中です。現在は docker-compose.yml を参照してください -->

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
PDFPlaywright による Headless Chromium

参加・コントリビュート

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

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

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

コントリビューター

<a href="https://github.com/srbhr/Resume-Matcher/graphs/contributors"> </a> <details> <summary><kbd>Star の推移</kbd></summary> <picture> <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=srbhr/resume-matcher&theme=dark&type=Date"> </picture> </details>

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