wehub-resource-sync
283 lines
15 KiB
Markdown
283 lines
15 KiB
Markdown
<div align="center">
|
||
|
||
[](https://www.resumematcher.fyi)
|
||
|
||
# Resume Matcher
|
||
|
||
[English](README.md) | [Español](README.es.md) | [简体中文](README.zh-CN.md) | **日本語**
|
||
|
||
[𝙹𝚘𝚒𝚗 𝙳𝚒𝚜𝚌𝚘𝚛𝚍](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)
|
||
|
||
求人ごとに最適化した履歴書を、AI の提案で作成できます。Ollama を使ってローカルで動かすことも、API 経由でお気に入りの LLM プロバイダに接続することも可能です。
|
||
|
||
|
||
|
||
</div>
|
||
|
||
<br>
|
||
|
||
<div align="center">
|
||
|
||
|
||
  
|
||
|
||
[](https://dsc.gg/resume-matcher) [](https://resumematcher.fyi) [](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>
|
||
|
||
|
||
|
||
</div>
|
||
|
||
> \[!IMPORTANT]
|
||
>
|
||
> 本プロジェクトには皆さまの支援が必要です。少額でもご寄付いただけると、Resume Matcher の開発と改善を続ける力になります。
|
||
|
||
<div align="center">
|
||
|
||
[](https://github.com/sponsors/srbhr) [](https://www.buymeacoffee.com/srbhr)
|
||
|
||
**企業としてのスポンサーをご検討ですか？** あなたのロゴを 27k 人超の開発者に届けましょう → **[スポンサーになる ↓](#sponsors)**
|
||
|
||
</div>
|
||
|
||
## はじめに
|
||
|
||
Resume Matcher は、まず「マスター履歴書」を作り、それを各求人応募向けに調整する形で動作します。インストール手順は：[インストール方法](#how-to-install)
|
||
|
||
### 仕組み
|
||
|
||
1. **アップロード**：マスター履歴書（PDF / DOCX）
|
||
2. **貼り付け**：応募先の求人票（Job Description）
|
||
3. **確認**：AI が生成した改善案と最適化内容
|
||
4. **生成**：求人向けのカバーレターとメール文面
|
||
5. **調整**：レイアウトやセクションを好みに合わせてカスタマイズ
|
||
6. **書き出し**：好みのテンプレートで PDF を出力
|
||
|
||
### コミュニティ
|
||
|
||
[](https://dsc.gg/resume-matcher)
|
||
|
||
ディスカッション、要望、サポートは [Discord](https://dsc.gg/resume-matcher) へ。
|
||
|
||
[](https://www.linkedin.com/company/resume-matcher/)
|
||
|
||
最新情報は [LinkedIn](https://www.linkedin.com/company/resume-matcher/) でも発信しています。
|
||
|
||
|
||
|
||
Star を付けていただけると開発の励みになります（リリース通知も受け取れます）。
|
||
|
||
<a id="sponsors"></a>
|
||
|
||
## スポンサー
|
||
|
||
|
||
|
||
Resume Matcher は無料かつオープンソースで、スポンサーと支援者の皆さまによって支えられています。役立つと感じたら、開発の支援をご検討ください。
|
||
|
||
### Resume Matcher を支える企業
|
||
|
||
企業ティアでスポンサーになると、**あなたのロゴ・リンク・紹介文がここに掲載されます** —— **27k 超の Star と 4.9k の Fork** を持つコミュニティに向けて。[Trendshift](https://trendshift.io/repositories/565) や [Vercel OSS プログラム](https://vercel.com/oss) にも掲載されています。
|
||
|
||
| Sponsor | Description |
|
||
|---------|-------------|
|
||
| [APIDECK](https://apideck.com?utm_source=resumematcher&utm_medium=github&utm_campaign=sponsors) | アプリを200以上のSaaSプラットフォーム（会計、HRIS、CRM、ファイルストレージ）に接続する単一のAPI。50回ではなく、1回の構築で統合を実現します。 🌐 [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 は AI 駆動の開発企業で、戦略・UX から DevOps まで、スケーラブルなクラウドソリューションを構築し、チームがより速くリリースしアイデアを本番へと導く支援をしています。 🌐 [zanreal.com](https://zanreal.com/?utm_source=resumematcher&utm_medium=github&utm_campaign=sponsors) |
|
||
| **✦ あなたの企業のロゴをここに** | 27k 超の開発者と 4.9k の Fork にリーチ。**[スポンサーになる →](https://github.com/sponsors/srbhr)** |
|
||
|
||
スポンサーシップがプロジェクトにどのように役立つかについての詳細は、[Sponsorship Guide](https://resumematcher.fyi/docs/sponsoring) をご覧ください。ReadME およびウェブサイトにて特別に感謝の意を表します。
|
||
|
||
<a id="support-the-development-by-donating"></a>
|
||
|
||
### 個人として支援する
|
||
|
||
|
||
|
||
少額の支援でも Resume Matcher を無料に保ち、新機能の開発を支えます —— ReadME とウェブサイトにて感謝の意をお伝えします。
|
||
|
||
| プラットフォーム | リンク |
|
||
|------------------|--------|
|
||
| GitHub | [](https://github.com/sponsors/srbhr) |
|
||
| Buy Me a Coffee | [](https://www.buymeacoffee.com/srbhr) |
|
||
|
||
## 制作者ノート
|
||
|
||
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)
|
||
|
||
## 主な機能
|
||
|
||
|
||
|
||
### コア機能
|
||
|
||
**マスター履歴書（Master Resume）**：既存の履歴書から、再利用できる包括的なマスター履歴書を作成します。
|
||
|
||
|
||
|
||
### 履歴書ビルダー
|
||
|
||
|
||
|
||
求人票を貼り付けると、その職種に合わせた AI 提案の履歴書を生成します。
|
||
|
||
できること：
|
||
|
||
- 提案内容の編集
|
||
- セクションの追加/削除
|
||
- ドラッグ＆ドロップで順序変更
|
||
- 複数テンプレートから選択
|
||
|
||
### カバーレター＆メール生成
|
||
|
||
求人票と履歴書に基づき、カスタマイズされたカバーレターとメール文面を生成します。
|
||
|
||
|
||
|
||
### 履歴書スコアリング（開発中）
|
||
|
||
履歴書と求人票を比較して、マッチスコアと改善提案を出す機能を開発中です。
|
||
|
||
|
||
|
||
### PDF 出力
|
||
|
||
最適化した履歴書とカバーレターを PDF として出力できます。
|
||
|
||
### テンプレート
|
||
|
||
| テンプレート名 | プレビュー | 説明 |
|
||
|---------------|-----------|------|
|
||
| **クラシック（1 カラム）** |  | 伝統的でクリーンなレイアウト。多くの業種に適しています。[PDF を見る](assets/pdf-templates/single-column.pdf) |
|
||
| **モダン（1 カラム）** |  | 可読性と美しさを重視した現代的なデザイン。[PDF を見る](assets/pdf-templates/modern-single-column.pdf) |
|
||
| **クラシック（2 カラム）** |  | セクションを分けて見やすく整理します。[PDF を見る](assets/pdf-templates/two-column.pdf) |
|
||
| **モダン（2 カラム）** |  | 2 カラムを活用して情報をより整理します。[PDF を見る](assets/pdf-templates/modern-two-column.pdf) |
|
||
|
||
### 国際化
|
||
|
||
- **多言語 UI**：英語・スペイン語・中国語・日本語に対応
|
||
- **多言語コンテンツ**：希望言語で履歴書とカバーレターを生成
|
||
|
||
### ロードマップ
|
||
|
||
提案や機能要望があれば、GitHub に Issue を立てるか、[Discord](https://dsc.gg/resume-matcher) でご相談ください。
|
||
|
||
- キーワードの視覚的ハイライト
|
||
- 定量的でインパクトのある内容を作る AI Canvas
|
||
- 複数求人票の同時最適化
|
||
|
||
<a id="how-to-install"></a>
|
||
|
||
## インストール方法
|
||
|
||
|
||
|
||
詳細なセットアップ手順は **[SETUP.ja.md](SETUP.ja.md)** を参照してください（[English](SETUP.md) / [Español](SETUP.es.md) / [简体中文](SETUP.zh-CN.md) も利用できます）。
|
||
|
||
### 前提条件
|
||
|
||
| ツール | バージョン | インストール |
|
||
|--------|------------|--------------|
|
||
| Python | 3.13+ | [python.org](https://python.org) |
|
||
| Node.js | 22+ | [nodejs.org](https://nodejs.org) |
|
||
| uv | 最新 | [astral.sh/uv](https://docs.astral.sh/uv/getting-started/installation/) |
|
||
|
||
### クイックスタート
|
||
|
||
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 app
|
||
|
||
# フロントエンド（ターミナル 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 |
|
||
| PDF | Playwright による Headless Chromium |
|
||
|
||
## 参加・コントリビュート
|
||
|
||
|
||
|
||
どなたでもコントリビュート歓迎です。開発者・デザイナー・ユーザーを問わず、協力してくれる方を募集しています。コントリビューター一覧は、公式サイトの [about ページ](https://resumematcher.fyi/about) と GitHub README に掲載されています。
|
||
|
||
ロードマップも参考にしてください。提案や機能要望があれば、GitHub で Issue を作成し、[Discord](https://dsc.gg/resume-matcher) でも議論できます。
|
||
|
||
<a id="contributors"></a>
|
||
|
||
## コントリビューター
|
||
|
||
|
||
|
||
<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 の推移</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 は [Vercel Open Source Program](https://vercel.com/oss) の一部です
|
||
|
||
|