安装与第一次启动

OpenCareer 是一个运行在本机上的求职工作台。第一次使用不需要注册云账户，也不需要先创建数据库；启动服务后，它会在当前工作区使用 .career-data/ 保存结构化记录和本地材料。

获取项目

推荐使用 Git 克隆：

git clone https://github.com/Glaube-TY/OpenCareer.git cd OpenCareer

如果你不使用 Git，也可以打开 OpenCareer GitHub 仓库，选择 Code → Download ZIP，将压缩包解压到一个长期使用的位置。

Windows 启动

进入项目目录后，直接双击：

start-opencareer.cmd

启动脚本会检查 Python 和依赖，随后启动本地服务并打开浏览器。默认地址是：

http://127.0.0.1:8721

如果 8721 端口已经被其他程序占用，脚本会提示打开已有实例，或者为当前工作区选择下一个可用端口。以终端最终显示的地址为准。

macOS 与 Linux 启动

先给脚本添加执行权限，再启动：

chmod +x start-opencareer.sh ./start-opencareer.sh

也可以直接使用：

bash start-opencareer.sh

手动启动

如果你希望自己控制依赖安装和启动过程，可以运行：

python -m pip install -r opencareer/requirements.txt python opencareer/app.py serve

终端会显示实际访问地址。正式使用时不要直接双击 opencareer/web/index.html，因为完整的数据读写和 Agent 能力依赖本地服务层。

第一次使用顺序

建议按下面的顺序逐步建立工作区：

1. 先完善个人资料；
2. 添加常用简历和附件；
3. 收集目标岗位；
4. 为决定申请的岗位建立投递记录；
5. 设置招聘阶段、面试安排和下一步计划；
6. 最后再接入 Agent。

不需要一次录入所有信息。OpenCareer 更适合随着真实求职过程逐渐完善。