jobhunt-app 0.6.0

Local-first, scrape-friendly software engineering job aggregator with rich filtering.

jobhunt

Search thousands of real job openings — locally, privately, with great filters.

No account needed. No data leaves your machine.

---

Install

Already have Python? This is the fastest way:

pip install jobhunt-app
jobhunt

Your browser opens. That's it.

---

Windows — open PowerShell, paste this:

irm https://raw.githubusercontent.com/Abdalla2004-collab/Jobhunt/main/scripts/install.ps1 | iex

Then type jobhunt.

macOS / Linux — open Terminal, paste this:

curl -fsSL https://raw.githubusercontent.com/Abdalla2004-collab/Jobhunt/main/scripts/install.sh | bash

Then type jobhunt.

---

Manage

What	How
Run	jobhunt
Update	jobhunt update — or Settings tab in the UI
Uninstall	uv tool uninstall jobhunt-app — or see Settings tab
Clear jobs	Settings tab > Clear all jobs
Auto-refresh	jobhunt --schedule 360 (every 6 hours)
Check sources	jobhunt doctor

---

What it does

• 17 job boards: Greenhouse, Lever, Ashby, Workable, SmartRecruiters, Recruitee, Workday, RemoteOK, HackerNews, SimplifyJobs, Arbeitnow, Jobicy, Himalayas, TheMuse, Arbeitsagentur, Jooble, Reed
• 15 filters: keyword, company, location, remote/hybrid/onsite, level, job type, salary, degree, experience, languages, skills, date, visa, CV match, sort
• Salary on every job (real data + smart estimates)
• CV match: upload your CV, sort by fit
• Saved search alerts: desktop notifications on new matching jobs
• Settings page: update, clear data, and uninstall — all from the UI

How it works

Companies use applicant-tracking systems (Greenhouse, Lever, Ashby, etc.) with public APIs. jobhunt reads from those APIs, stores everything locally, and gives you a search UI with filters and a CV matcher.

Does not scrape LinkedIn or Indeed.

Privacy

Everything runs on your machine. No telemetry, analytics, or update pings. UI only listens on 127.0.0.1.

OS	Data stored at
Windows	%APPDATA%\jobhunt\
macOS	~/Library/Application Support/jobhunt/
Linux	~/.local/share/jobhunt/

For developers

git clone https://github.com/Abdalla2004-collab/Jobhunt && cd Jobhunt
uv venv && source .venv/bin/activate
uv pip install -e ".[dev]"
pytest -q && jobhunt

See CONTRIBUTING.md.

License

MIT