README.ja.md
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 は、まず「マスター履歴書」を作り、それを各求人応募向けに調整する形で動作します。インストール手順は:インストール方法
ディスカッション、要望、サポートは Discord へ。
最新情報は LinkedIn でも発信しています。
Star を付けていただけると開発の励みになります(リリース通知も受け取れます)。
スポンサーの皆さまに感謝します。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 |
<a id="support-the-development-by-donating"></a>
スポンサーシップがプロジェクトにどのように役立つかについての詳細は、Sponsorship Guide をご覧ください。ReadME およびウェブサイトにて特別に感謝の意を表します。
| プラットフォーム | リンク |
|---|---|
| GitHub | |
| Buy Me a Coffee |
Resume Matcher をご覧いただきありがとうございます。つながりやコラボレーション、あるいは挨拶だけでも、お気軽にご連絡ください! ~ Saurabh Rai ✨
以下でフォローできます:
マスター履歴書(Master Resume):既存の履歴書から、再利用できる包括的なマスター履歴書を作成します。
求人票を貼り付けると、その職種に合わせた AI 提案の履歴書を生成します。
できること:
求人票と履歴書に基づき、カスタマイズされたカバーレターとメール文面を生成します。
履歴書と求人票を比較して、マッチスコアと改善提案を出す機能を開発中です。
最適化した履歴書とカバーレターを PDF として出力できます。
| テンプレート名 | プレビュー | 説明 |
|---|---|---|
| クラシック(1 カラム) | 伝統的でクリーンなレイアウト。多くの業種に適しています。PDF を見る | |
| モダン(1 カラム) | 可読性と美しさを重視した現代的なデザイン。PDF を見る | |
| クラシック(2 カラム) | セクションを分けて見やすく整理します。PDF を見る | |
| モダン(2 カラム) | 2 カラムを活用して情報をより整理します。PDF を見る |
提案や機能要望があれば、GitHub に Issue を立てるか、Discord でご相談ください。
<a id="how-to-install"></a>
詳細なセットアップ手順は 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 プロバイダを設定してください。
| プロバイダ | ローカル/クラウド | 備考 |
|---|---|---|
| Ollama | ローカル | 無料。手元のマシンで動作 |
| OpenAI | クラウド | GPT-4o、GPT-4o-mini |
| Anthropic | クラウド | Claude 3.5 Sonnet |
| Google Gemini | クラウド | Gemini 1.5 Flash/Pro |
| OpenRouter | クラウド | 複数モデルへアクセス |
| DeepSeek | クラウド | DeepSeek Chat |
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 |
| Playwright による Headless Chromium |
どなたでもコントリビュート歓迎です。開発者・デザイナー・ユーザーを問わず、協力してくれる方を募集しています。コントリビューター一覧は、公式サイトの about ページ と GitHub README に掲載されています。
ロードマップも参考にしてください。提案や機能要望があれば、GitHub で Issue を作成し、Discord でも議論できます。
<a id="contributors"></a>