AIHawk 快速上手指南

AIHawk 是一款开源的 AI 求职代理工具，旨在自动化职位申请流程。其核心架构完全开源，允许开发者审查和扩展代码库（注：出于版权考虑，本仓库已移除所有第三方提供商插件）。

环境准备

在开始之前，请确保您的开发环境满足以下要求：

• 操作系统：Linux、macOS 或 Windows (推荐 WSL2)
• Python 版本：Python 3.10 或更高版本
• 包管理器：pip 或 poetry
• 浏览器驱动：需安装对应浏览器的 WebDriver（如 ChromeDriver），或使用 Selenium Manager 自动管理
• 账号准备：有效的 LinkedIn 账号及简历文件（PDF 格式）

国内加速建议： 建议使用国内镜像源安装依赖，以提升下载速度：

pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple

安装步骤

1. 克隆项目仓库 将代码克隆到本地目录：

   git clone https://github.com/AIHawk/Jobs_Applier_AI_Agent_AIHawk.git
   cd Jobs_Applier_AI_Agent_AIHawk
   

2. 创建虚拟环境 推荐使用 venv 隔离依赖：

   python -m venv venv
   

3. 激活虚拟环境

   • Linux/macOS:

     source venv/bin/activate
     

   • Windows (PowerShell):

     .\venv\Scripts\Activate.ps1
     

4. 安装依赖 安装项目所需的 Python 包：

   pip install -r requirements.txt
   

5. 配置参数 复制配置文件模板并根据实际情况修改（填入 LinkedIn 账号信息、简历路径及搜索偏好）：

   cp config.yaml.example config.yaml
   

   编辑 config.yaml 文件，填入您的 linkedin_username, linkedin_password, resume_path 等关键信息。

基本使用

完成配置后，即可启动 AI 代理开始自动投递。

运行主程序：

python main.py

执行逻辑说明：

1. 程序将自动启动浏览器并登录您的 LinkedIn 账号。
2. 根据 config.yaml 中设定的关键词、地点和职位类型进行搜索。
3. AI 将自动分析职位描述，匹配您的简历，并提交申请。
4. 终端将实时输出投递状态和统计信息。

注意：首次运行时，请确保网络连接稳定，并留意终端提示以完成可能的人机验证（如有）。