跳到主要内容

安装 Sweepy

运行 Sweepy 之前，你的电脑上需要准备三样东西：

  1. Python： 驱动引擎的编程语言。
  2. Git： 从互联网下载引擎代码的工具。
  3. pip： 安装引擎所需额外库的包管理器。Windows 和 macOS 的官方安装程序自带 pip。Linux 发行版通过系统包管理器安装 pip。
备注

本指南面向从未打开过终端的读者，逐步讲解每个环节。如果你已安装 Python 3.10+ 和 Git，可直接跳到第 3 步。

第 1 步：打开终端​

终端也称命令行，是一个以文本为主的窗口，你在其中输入命令。你在这里直接向电脑输入指令，而不是点击图标。

按 Windows 键，输入 PowerShell，然后选择 Windows PowerShell。

终端
Windows PowerShell
Copyright (C) Microsoft Corporation. All rights reserved.

PS C:\Users\YourName>

提示符末尾有一个闪烁的光标。该光标表示终端已就绪，可以接收命令。

第 2 步：检查并安装 Python​

Sweepy 需要 Python 3.10 或更高版本。先检查是否已安装。

在终端中输入以下命令并按 Enter：

终端
python --version

在 macOS 和 Linux 上，命令为 python3 --version。

如果显示 Python 3.10.x 或更高版本，说明你已安装 Python。请跳到第 3 步。

如果出现 'python' is not recognized 之类的错误信息，或版本低于 3.10，请按以下步骤安装。

  1. 访问 Windows 版 Python 下载页面。
  2. 选择最新的 Windows installer (64-bit) 下载链接。
  3. 运行下载的文件。
  4. 这一步至关重要。 在安装程序第一个界面的底部，勾选标有 “Add python.exe to PATH” 的复选框。该复选框会把 Python 加入 PATH，终端才能找到它。
  5. 选择 Install Now，等待安装完成。

然后在新的终端窗口中确认安装：

终端
PS C:\Users\YourName> python --version
Python 3.13.1
警告

如果跳过“Add python.exe to PATH”，终端将无法识别 python 命令。请卸载 Python，再勾选该复选框重新安装。

Windows、macOS 和 Linux 三个标签页都以同一项检查收尾。关闭终端后重新打开，再运行版本命令。版本号为 3.10 或更高，说明 Python 已就绪。

第 3 步：下载 Sweepy​

下载 Sweepy 的源文件

请选择一种方式。使用下方介绍的 Git，或从 Sweepy 发布页面 下载 ZIP 文件。

Git 把项目文件复制到你的电脑，并记录文件历史。正是这段历史让 Sweepy 能够自我更新。下面的步骤使用 Git。

  • Git 副本。 运行 sweepy --update，或使用 Sweepy 工具箱里的更新功能，拉取每个新版本。
  • ZIP 副本。 每个版本都要重新下载、解压，并再次运行 pip install -e .。自动更新保持关闭，因为 ZIP 没有可供拉取的 Git 历史。
  • 文件夹名称。 Git 创建名为 sweepy 的文件夹。ZIP 解压后得到类似 sweepy-main 的文件夹，因此本步骤后面的 cd 命令需要相应调整。

只想试用一次，选 ZIP。打算长期使用 Sweepy，选 Git。

先检查是否已安装 Git：

终端
git --version

如果显示 git version 2.45.1 之类的版本号，说明已安装 Git。如果出现错误，请安装 Git：

  1. 访问 git-scm.com/download/win。
  2. 下载并运行安装程序。
  3. 接受全部默认设置，选择 Install。
  4. 关闭并重新打开终端，然后确认：
终端
PS C:\Users\YourName> git --version
git version 2.45.1

现在运行以下命令下载 Sweepy：

终端
git clone https://github.com/pvega62/sweepy.git

该命令会在你的电脑上创建名为 sweepy 的新文件夹。进入该文件夹：

终端
cd sweepy
提示

Git 会把新文件夹放在运行命令时终端所在的目录中。在 Windows 上，新建的 PowerShell 窗口起始位置为 C:\Users\YourName\。

第 4 步：安装依赖​

Sweepy 运行时依赖几个额外的库：

  • pymupdf： 读取并提取简历 PDF 中的文本。
  • python-docx： 读取并转换 .docx 简历。
  • python-jobspy： 安全抓取招聘网站，无需 API 密钥。
  • beautifulsoup4： 解析 Greenhouse、Lever、Workable 和 Built In 源的 HTML。
  • reportlab： 生成带样式的 PDF 报告，含可点击链接。
  • requests： 发送网络请求，检查 URL 是否仍可访问。
  • pyyaml 与 questionary： 负责交互式配置向导。prompt-toolkit 提供其键盘控制。
  • pandas： 组织抓取的职位数据并生成 CSV 表格导出文件。
  • mcp 与 anyio： 运行可选的模型上下文协议服务器，将 Sweepy 连接到 AI 助手。
Python 3.13

如果你使用 Python 3.13，请先安装 Microsoft C++ Build Tools，并选择 “Desktop development with C++” 工作负载。Python 3.13 发布较新，部分包（例如 pymupdf）可能从源码编译，因而需要这些工具。使用 Python 3.12 或更早版本时可跳过此步。

Sweepy 的自动化测试覆盖 Python 3.10 至 3.12。这些版本仍是最顺畅的路径。

用一条命令安装所有包：

终端
pip install -e .

该命令安装所有依赖，并在 Python Scripts 文件夹中注册 sweepy 命令。重新打开一次终端，让 PATH 收录新文件夹。此后运行 sweepy --run，不必再运行 python swee.py --run。两种形式都需在 sweepy 文件夹中执行。

Python 下载并安装各个包时，文本会不断滚动。光标重新出现即表示安装完成。

提示

遇到 pip 的“command not found”错误？请改用 pip3 install -e .。在部分系统上，Python 3 的命令名为 pip3。

验证安装​

运行以下快速检查，确认安装无误：

终端
sweepy --version

如果 shell 找不到 sweepy，请重新打开终端，或改为运行 python swee.py --version。你将看到：

终端输出
Sweepy v3.0.0
Python 3.13.1 | pymupdf 1.28.2 | reportlab 5.0.1
Ready to sweep.

出现该信息说明 Sweepy 已就绪。你机器上的数字可能不同。Sweepy 从 VERSION 文件打印版本号，pip 安装与你的 Python 版本匹配的包。

第二行显示 pymupdf 和 reportlab 的版本。

接下来，配置你的个性化职位搜索配置文件。