Repository navigation
v1.0 — first stable release
Self-hosted job-hunt automation: scrape boards and career pages, score jobs against your résumés with Claude, tailor résumés and cover letters, capture LinkedIn roles via a Chrome extension, monitor Gmail for replies, and manage it all from a React dashboard.
What's inside
- Discovery: 6 scraping tiers — JobSpy (LinkedIn/Indeed/ZipRecruiter/Google), Levels.fyi, LinkedIn collections, Jobright.ai, direct career pages (auto-detects Workday, Greenhouse, Ashby, Lever, Oracle HCM, SmartRecruiters, Rippling, and more), plus the "Navigator" Chrome extension. Two-layer dedup.
- AI: per-résumé scoring (5-criteria rubric, apply recommendations), grounded résumé tailoring and cover-letter generation, click-tracking tracer links.
- Tracking: Kanban application board, status-transition history, Gmail response monitoring, Telegram alerts/digests.
- Dashboard: React + Tailwind (dark mode), keyboard-driven Job Feed, editable settings (LLM providers/models, rubric, filters) — only secrets live in
.env, everything else in the DB.
Getting started
git clone https://github.com/vesaias/JobNavigator.git
cd JobNavigator
docker compose up --build -dPersonal/educational use. Not affiliated with any job platform. Some scrapers are opt-in — comply with each platform's ToS. See
LEGAL_DISCLAIMER.md.