- 社区热度
- 242 Stars
- GitHub 收藏
- 最近活跃
- 2026/9/28
- 近 30 天还在更新
- 授权协议
- MIT
- 宽松协议
为什么值得关注
不是看 Star 排名，而是看它解决了什么问题、实际有没有用，以及方法为什么值得关注。
解决的问题
针对 HH.ru 平台求职过程中的重复性筛选与求职信撰写任务，通过自动化手段降低了求职者的手动操作负担。
实际价值
提供了完整的交互式配置向导、多种 LLM 后端支持以及 Telegram 远程审批机制，具备较好的实际操作可行性。
创新 / 差异化
引入了基于 LLM 的匹配度评估与分阶段审批模式，在自动化效率与人工决策权之间取得了平衡。
扩展潜力
通过 SQLite 状态管理与模块化架构，使得个人用户能够以较低的维护成本运行私有化求职代理。
为什么是现在
在 LLM 应用普及的背景下，此类针对特定垂直领域（招聘平台）的自动化工具具有明确的实用价值。
社区活跃度
近 90 天新增 6 个 Issue、8 个 PR；窗口内抽取的 Issue/PR 样本中有 6 位 Issue 发起者、3 位 PR 贡献者，并发布 7 个版本。
维护者响应
窗口内 6 个 Issue 样本关闭率 100%，8 个 PR 样本合并率 75%。维护者评论样本仅覆盖该 Issue 样本的 100%，不足以可靠判断首次响应率与响应速度。
核心亮点
- 自动搜索HH.ru上的职位
- 通过LLM评估职位匹配度
- 生成个性化求职信
快速开始
安装方式、上手难度、开始步骤。
装在哪
自托管（装在自己服务器）
难不难
中等，需要一点配置
- 01运行
python setup_wizard.py启动设置向导 - 02输入 Telegram Bot 令牌和你的 User ID
- 03选择 AI 提供商（Ollama、Mistral API 或 OpenAI-compatible）
- 04输入你的个人资料数据用于职位分析
- 05选择工作模式（dry_run 或 approval）
- 06等待向导创建
.env和profile.yaml并检查配置 - 07根据提示进行后续操作
更适合谁
- 希望数据放在自己服务器上的团队
- 想在本机直接跑起来试用的开发者
- 习惯用 Docker 部署的人
更多介绍
HH AI Agent 是一个自动搜索HH.ru职位空缺的代理。它通过LLM评估职位，生成求职信，并将合适的职位发送到Telegram。
快速开始
运行python setup_wizard.py启动设置向导，它将引导你完成所有步骤：
- Telegram Bot令牌和你的User ID
- 选择AI提供商（Ollama本地、Mistral API或任何OpenAI兼容的）
- 你的个人资料数据用于分析职位
- 工作模式
之后会创建.env和profile.yaml，检查配置并显示下一步。
工作模式
| 模式 | 描述 |
|---|---|
dry_run |
搜索并分析职位，在Telegram发送预览——不实际投递 |
approval |
发送职位并附带“投递”按钮——只有在你点击后才投递 |
建议从dry_run开始。卡片显示匹配解释、公司评分和可展开的求职信。
LLM提供商
- Ollama（推荐）：本地免费，安装Ollama并拉取模型（如llama3）
- Mistral API：云服务，需要注册获取API密钥
- OpenAI-compatible：任何兼容的端点（LocalAI、LM Studio、Groq等）
安全
- 实际投递需要三个同时条件：
APP_MODE=approval+ENABLE_REAL_APPLY=true+ 点击按钮且是绑定的Telegram ID；一次性许可在点击后30分钟内有效 - 没有批量自动模式
.env、profile.yaml和.browser-profile/从Git排除- 令牌、cookies和完整
.env不会记录到日志
信息来源
每条信息都标注了状态与出处，可展开查看。
11 条 · 展开
信息来源
每条信息都标注了状态与出处，可展开查看。
capability tags
已核验automation、content_creation、productivity
来源： admin_cms · cms editor · 2026/8/14
最新版本
已核验v1.2.7
来源： GitHub 官方接口 · latest_release=v1.2.7 · 2026/10/2
许可证
已核验MIT
来源： GitHub 官方接口 · license.spdx_id=MIT · 2026/10/2
needs api key
已核验否
来源： admin_cms · cms editor · 2026/8/14
一句话用途
已核验{"en":"Job-search agent that finds HH.ru vacancies, evaluates them with an LLM, generates cover letters, and sends suitable matches to Telegram.","zh":"自动搜索 HH.ru 职位，用 LLM 评估匹配度、生成求职信，并把合适职位发送到 Telegram 的求职代理。"}
来源： admin_cms · cms editor · 2026/8/14
平台
已核验windows、macos、linux
来源： admin_cms · cms editor · 2026/8/14
product forms
已核验cli
来源： admin_cms · cms editor · 2026/8/14
role tags
已核验来源： admin_cms · cms editor · 2026/8/14
supports docker
已核验是
来源： 仓库文件 · dockerfile=true; compose=true · 2026/10/2
supports local
已核验是
来源： admin_cms · cms editor · 2026/8/14
supports self host
已核验是
来源： admin_cms · cms editor · 2026/8/14
相关项目
根据分类、能力和适用角色匹配的其他已核验项目。
agent-device
为 AI 编程助手提供移动端应用自动化与验证能力，支持 iOS、Android、HarmonyOS 等多平台的实时交互与测试。
marketing-studio
基于 Claude Code 的自动化营销资产生成引擎，通过单一指令即可完成产品演示、Logo 动画、社交媒体短片及发布视频的制作。
woodpecker
可自行部署并通过插件扩展的 CI/CD 引擎，服务端默认可使用 SQLite，适合构建自动化流水线。
Rundeck
自托管 Runbook 自动化平台，用 Web 控制台、CLI 和 API 把人工运维步骤编排成可重复、可授权的作业。
qwen-audio-agent
一个支持全双工实时语音交互的 AI Agent 运行时，可在后台异步执行任务并保持对话连贯。
superplane
SuperPlane 是一个面向 AI 代理工程的开源控制平面，旨在解决复杂工程工作流（如 CI/CD、事件驱动运维、人工审批）难以被 AI 安全且确定性地执行的问题。