feder-cr/Jobs_Applier_AI_Agent
1
0 Fork 0
mirror of https://github.com/feder-cr/Jobs_Applier_AI_Agent.git synced 2026-11-07 02:35:57 -10:00
Code Issues Packages Projects Releases 1 Wiki Activity

README: say it in two lines, then the commands

Browse Source 
In the voice of the other READMEs: what others do, what this one does, and the install. The measurements move to docs/sites.md.
This commit is contained in:
feder-cr committed 2026-11-05 18:17:48 +01:00
1 parent 7987df831b
commit d559055ef2
2 files changed
+28 -59
Download Patch File Download Diff File Expand all files Collapse all files

No files matched your search

README.md
+20 -59
View File
@@ -5,8 +5,8 @@
<source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/feder-cr/Jobs_Applier_AI_Agent/main/assets/banner-dark.gif">
<img alt="AIHawk, a short film. Your name typed into one form, then another, then the CV you just attached. Nobody wants to apply for a job. You want the job. 10,213,067 postings narrow to 25, each with its reasons. You pick, you say yes once, and a browser you can watch fills the form and sends it. An illustration, with invented companies and an invented person." src="https://raw.githubusercontent.com/feder-cr/Jobs_Applier_AI_Agent/main/assets/banner-light.gif" width="100%">
</picture>
<h3 align="center">Applying by hand takes days, and most postings do not fit you.<br>
AIHawk narrows 10 million of them down to the ones that fit your resume, and applies to those you pick, in a browser you can watch.</h3>
<h3 align="center">Other job bots apply to everything.<br>
This one applies where you fit.</h3>
<sub>THE EARLIER AIHAWK WAS FEATURED IN</sub><br>
<a href="https://www.businessinsider.com/aihawk-applies-jobs-for-you-linkedin-risks-inaccuracies-mistakes-2024-11"><b>Business Insider</b></a> ·
@@ -18,24 +18,6 @@ AIHawk narrows 10 million of them down to the ones that fit your resume, and app
<a href="https://www.404media.co/i-applied-to-2-843-roles-the-rise-of-ai-powered-job-application-bots/"><b>404 Media</b></a>
</div>
<br>
## How it works
A job search asks two questions, and AIHawk answers both.
**1. Which jobs fit you?** It narrows about 10.2 million postings, from 24 public sources rebuilt daily, down to the few worth reading.
- Your resume becomes a search plan, a graph of the words your jobs use, each with a weight. 600 postings fit it by their titles, found on your computer with no model.
- [Jev](https://github.com/feder-cr/jev), a decision model, reads 100 of them against your resume.
- A chat model scores the best 25 from 1 to 5, with the gaps and the reasons.
**2. Can it get through the form?** You select the jobs and say yes once.
- The model fills every required field, from what your resume says and what it implies, and attaches your CV.
- It drives [invisible-playwright-mcp](https://github.com/feder-cr/invisible_playwright_mcp), a real Firefox with a person's hands, in a window you can watch.
- AIHawk clicks send, reads the page, and keeps what it said for each job.
---
## Install
@@ -52,64 +34,43 @@ Linux:
curl -LsSf https://raw.githubusercontent.com/feder-cr/Jobs_Applier_AI_Agent/main/run.sh | sh
```
It installs what is missing, updates AIHawk and starts it. It is the same command every time. You need a key: [get one from OrcaRouter](https://www.orcarouter.ai/ref/ref_accd17afb78fc95ac4d7).
The same command starts and updates it. You need a key: [get one from OrcaRouter](https://www.orcarouter.ai/ref/ref_accd17afb78fc95ac4d7).
---
## How it works
1. **It finds the jobs.** About 10 million postings, rebuilt daily, narrowed to your resume on your computer. [Jev](https://github.com/feder-cr/jev) reads the best 100.
2. **It scores them.** The best 25, from 1 to 5, with the gaps and the reasons.
3. **You say yes once.** It fills the forms you picked, attaches your CV and sends, in [a Firefox](https://github.com/feder-cr/invisible_playwright_mcp) you can watch.
---
## Usage
The screen asks for your key and your resume, then shows the jobs, best first.
| Key | What it does |
|---|---|
| `enter` | why this score: the gaps and the reasons |
| `enter` | why this score |
| `space` | select a job |
| `a` | send the selected jobs, after one yes |
| `s` | every application, and what each page said |
| `m` | score the next ones |
| `e` | settings: resume, sign-in to your mail and job sites, what to look for, where, models |
---
## Measured
| What | Result |
|---|---|
| Ranking, graded blind on real postings | nDCG@10 of 0.683, against 0.569 before Jev; 0.4 wrong jobs in the top 10 |
| Form model, on a local course of hard forms, of 100 | DeepSeek v4.1 flash 87, GLM 83, Gemini 81 |
| A form, on real sites | 0.4 to 3.3 cents in model calls; 3 to 27 minutes |
| `e` | settings |
---
## Before you send
- **It goes out in your name, unread, after one yes.** Where your resume says nothing, the model writes "Please see my attached CV", picks the closest option or a plausible number, and ticks the boxes the form requires, statements such as the right to work included. You answer for all of it. Sites have terms of their own, and some do not allow this.
- **Nothing checks what the model does in the browser.** It is told to leave the send to AIHawk, and it could send early or half filled: [SECURITY.md](SECURITY.md).
- **Your data.** Your CV, the postings and the pages, screenshots included, go to OrcaRouter and its providers, on your paid key. The rest stays in `~/.aihawk`, sign-ins included.
- **Downloads.** About 740 MB of job index on the first search, and about 268 MB of browser on the first form. Windows and Linux: the browser has no macOS build.
- **The job data is not ours.** Each posting belongs to its employer. Some sources state no licence, and one asks not to be republished as listings; the published database includes it: [every source](docs/data-sources.md).
- **It goes out in your name, unread.** Where your resume says nothing, the model writes "Please see my attached CV", picks the closest option or a plausible number, and ticks the boxes the form requires, the right to work included. You answer for all of it, and some sites do not allow this.
- **Nothing checks the model in the browser.** It could send early or half filled: [SECURITY.md](SECURITY.md).
- **Your data.** Your CV and the pages go to OrcaRouter and its providers. The rest stays in `~/.aihawk`.
- **Downloads.** About 740 MB of job index and 268 MB of browser. Windows and Linux.
- **The job data is not ours.** Some sources state no licence, and one asks not to be republished: [every source](docs/data-sources.md).
---
## Documentation
[Configuration](docs/configuration.md) · [Sites](docs/sites.md) · [Writing a plugin](docs/plugins.md) · [Data sources](docs/data-sources.md) · [Wiki](https://github.com/feder-cr/Jobs_Applier_AI_Agent/wiki) · [Contributing](CONTRIBUTING.md) · [Security](SECURITY.md) · [Changelog](CHANGELOG.md)
## Related projects
- **[invisible-playwright-mcp](https://github.com/feder-cr/invisible_playwright_mcp)** - the browser AIHawk drives, as an MCP server for any assistant.
- **[invisible_playwright](https://github.com/feder-cr/invisible_playwright)** - Playwright on an anti-detect Firefox, the engine underneath.
- **[Jev](https://github.com/feder-cr/jev)** - yes/no decisions on a laptop CPU.
- **[invisible_dots](https://github.com/feder-cr/invisible_dots)** - the former Dots project, once in this repository.
[Sites](docs/sites.md) · [Configuration](docs/configuration.md) · [Writing a plugin](docs/plugins.md) · [Wiki](https://github.com/feder-cr/Jobs_Applier_AI_Agent/wiki) · [Contributing](CONTRIBUTING.md) · [Changelog](CHANGELOG.md)
Built with [OrcaRouter](https://www.orcarouter.ai/ref/ref_accd17afb78fc95ac4d7). Its links here and on the screen are referral links: AIHawk gets 6% of what you spend through them.
---
## License
[MIT](LICENSE) for the code. See [NOTICE](NOTICE).
## Disclaimer
This project is provided as-is, with no warranties. Applications go out in your name, and you answer for them and for following each site's terms and the laws of your jurisdiction.
[MIT](LICENSE) for the code, see [NOTICE](NOTICE). Provided as-is, with no warranties. Applications go out in your name, and you answer for them and for following each site's terms and the laws of your jurisdiction.
docs/sites.md
+8
View File
@@ -28,3 +28,11 @@ Notes:
- A form asks the person for whatever the CV and answers do not cover, then tries again. In trials with test answers most forms stopped there, as they should.
- Greenhouse's confirmation page was not saved, so its plugin keeps generic wording. Ashby's, Breezy's, Recruitee's and Teamtailor's are quoted in their plugins.
- A captcha shown as a box is clicked, twice at most, as a person would. It is not solved: on a puzzle the form stops as blocked, for the person to do by hand.
## Measured
| What | Result |
|---|---|
| Ranking, graded blind on real postings | nDCG@10 of 0.683, against 0.569 before Jev; 0.4 wrong jobs in the top 10 |
| Form model, on a local course of hard forms, of 100 | DeepSeek v4.1 flash 87, GLM 83, Gemini 81 |
| A form, on real sites | 0.4 to 3.3 cents in model calls; 3 to 27 minutes |