前置要求
- Python 3.13+
- Node.js 22+
- uv
- npm
安装 uv：
curl -LsSf https://astral.sh/uv/install.sh | sh本地开发环境搭建
克隆 Resume Matcher 主应用仓库，然后在两个终端里分别启动后端和前端。
git clone https://github.com/srbhr/Resume-Matcher.git
cd Resume-Matcher
# Terminal 1
cd apps/backend
cp .env.example .env
uv sync
uv run app
# Terminal 2
cd apps/frontend
npm install
npm run dev默认本地地址
- 前端：
http://localhost:3000 - 后端：
http://127.0.0.1:8000
前端默认在 http://127.0.0.1:8000 查找后端。
Resume Matcher 靠捐助维持运转。
已有超过 20 万求职者用过它：免费，没有广告，也没有付费墙。如果它帮你省了时间，或帮你拿到了面试，赞助或请我喝杯咖啡能让它一直免费。
PDF 导出需要 Playwright
PDF 生成使用 Playwright 和 Chromium。安装完后端依赖后，运行：
cd apps/backend
uv run playwright install chromium跳过这一步的话，只有电脑上装了 Chrome 或 Edge，PDF 导出才能工作，因为应用会改用它们。
PDF 导出还需要前端处于运行状态，因为 Chromium 打印的是前端的打印页面。
说明
- 在
apps/frontend里运行npm install只安装前端依赖。 - 本地开发时，前端和后端分别启动。
- 两个服务都跑起来后，在
http://localhost:3000/settings配置 AI 服务商。 - 你的数据存进
apps/backend/data/里的一个 SQLite 数据库，无需任何配置。想改用 PostgreSQL，参见用 PostgreSQL 代替 SQLite。 - 支持的服务商包括 OpenAI、Anthropic、OpenRouter、Google Gemini、DeepSeek、Groq、Azure AI Foundry、Ollama 和兼容 OpenAI 接口的服务，也可以用你的 ChatGPT 或 Claude 订阅。参见自带 AI 密钥。
故障排查
找不到 uv
安装：
curl -LsSf https://astral.sh/uv/install.sh | shPython 版本不对
检查：
python --versionResume Matcher 本地开发需要 Python 3.13+。
前端连不上 API
确认后端正在 http://127.0.0.1:8000 运行。
PDF 导出失败
先确认前端正在运行，然后在 apps/backend 目录下重新运行：
uv run playwright install chromium