安装配置

安装

在本地搭建 Resume Matcher 开发环境

前置要求

  • 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 查找后端。

PDF 导出需要 Playwright

PDF 生成依赖 Playwright 和 Chromium。安装完后端依赖后，运行：

cd apps/backend
python -m playwright install chromium

跳过这一步，PDF 导出会失败。

说明

  • 在 apps/frontend 里运行 npm install 只安装前端依赖。
  • 本地开发时，前端和后端分别启动。
  • 两个服务都跑起来后，在应用里配置 AI 服务商。
  • 支持的服务商包括 OpenAI、Anthropic、OpenRouter、Google Gemini、DeepSeek、Groq、Azure AI Foundry、Ollama 和兼容 OpenAI 接口的服务。参见自带 AI 密钥。

故障排查

找不到 uv

安装：

curl -LsSf https://astral.sh/uv/install.sh | sh

Python 版本不对

检查：

python --version

Resume Matcher 本地开发需要 Python 3.13+。

前端连不上 API

确认后端正在 http://127.0.0.1:8000 运行。

PDF 导出失败

重新运行：

python -m playwright install chromium

下一步

返回全部文档