Skip to content

v1.0 — first stable release

Choose a tag to compare

@vesaias vesaias released this 15 Aug 19:21

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 -d

Personal/educational use. Not affiliated with any job platform. Some scrapers are opt-in — comply with each platform's ToS. See LEGAL_DISCLAIMER.md.