Free · open source · MITWindows · macOS · Linux

Be seen.Not buried.

JobHunterX reads your resume, finds real openings on companies’ own job boards, and tells you how well each one fits — and how likely a person is to actually read your application. Then it writes honest documents and helps you apply, while you watch.

01 — The feed

One post. Hundreds of applicants. You’re late.

A public listing on a big job site can collect hundreds of applicants within days. Recruiters read the first few dozen and filter on years, current company and notice period. Early in your career, you’re often filtered out unread. So “apply to more” doesn’t work.

02 — Read

First, it reads you. Properly.

Upload your resume once. It builds a profile — roles, skills and where you used them, location — and shows you a “how we see you” screen to correct before any search.

  • 2 yrs 1 moExperience is computed from your dates — never guessed
  • At workSkills are marked by evidence: used at work, in projects, or only listed
  • HyderabadWhere you are, and whether you’d move
Example resume
03 — Find

Then it goes to the source.

An employer job board is the careers page a company runs itself, usually through a hiring system like Greenhouse, Lever or Ashby. Posts there are first-hand, and often appear before the big sites copy them. Web search results are only leads — every posting is checked: real, reachable, open, in your country.

  • Greenhouse
  • Lever
  • Ashby
  • Workday
  • Keka
  • YC startups
  • Watchlist · every 4 h
04 — Measure

Most don’t fit. It says why.

Hard checks come first: career track, years, location, must-have skills, notice period. A failed hard check caps the score, so keywords can’t lift a job you can’t get. The ones left get two separate readings — fit, and your chance to be seen.

  • needs 6+ years
  • outside India
  • other career track
  • must-have missing
05 — Write

Honest papers. Nothing invented.

For the job you pick: a one-page resume, a cover letter under 300 words, and a CV of your whole career. Every AI-written line is fact-checked against your profile. A new number, tool or employer is rejected — your own words stay. Skills you lack are listed for you, never added.

06 — Apply

It fills the form. You hold the wheel.

Press Auto-apply and a private browser opens, streamed inside the app, every step in plain words. Stop halts it at once. Take over hands the page to you — for a CAPTCHA, a login, anything. Give back, and it carries on from where you left it.

Illustration on a pretend page
07 — Track

Every application, in its place.

Saved, Preparing, Applied, Interviewing, Offer, Closed. One click to the next stage. Log how you applied and what happened, and see which routes actually get you interviews.

Hands on

Don’t take our word. Try the two ideas.

Two small simulations with example data. Nothing here talks to a server, and nothing is submitted anywhere.

A · Fit vs. chance to be seen

Pick a job. See both readings.

Candidate: about 1.5 years of AI work, Hyderabad, not relocating. The cases mirror an example in the project’s tests; the numbers are illustrative.

Fit0
Chance to be seen0
    B · The browser agent

    Start it. Then take the wheel.

    The agent will hit a “not a robot” check and wait for you.

    careers.example.com/apply/ai-engineerAGENT
    Apply · AI Engineer
    ResumeNo file chosen
    Ready
      Every search, in ten moves

      What happens when you press Search.

      Each step names the part of the code that does it.

      Keep scrolling →
      01

      Understand

      Career tracks, realistic titles, skills with evidence. Years computed from dates. Every AI claim is checked against your profile.

      intelligence/candidate.py
      02

      Plan

      Varied searches from your own titles and places, aimed at employers’ hiring systems.

      discovery/search.py
      03

      Discover

      Search results are leads. Employer boards and watchlist companies are read through public APIs. Out-of-country jobs drop here.

      discovery/ats.py
      04

      Normalize

      Every lead becomes one posting: hiring-system API first, then page data, then page text.

      discovery/page.py
      05

      Dedupe

      The same job from many places becomes one. The first-hand source wins.

      discovery/dedupe.py
      06

      Validate

      Real, reachable, current, open. Each field is verified, inferred or unknown — and unknown stays unknown.

      discovery/validate.py
      07

      Extract

      Required vs nice-to-have skills, years, notice, salary. Numbers only count with a quote from the post.

      intelligence/job.py
      08

      Match

      Hard checks first. A failed one caps the score. Then weighted parts: role, skills by evidence, experience, location.

      intelligence/matching.py
      09

      Rank & explain

      A 0–100 score and verdict, strengths, gaps, unknowns — plus the separate chance to be seen.

      intelligence/reach.py
      10

      Connect

      For top matches: an email the post itself gives (never guessed), search links to recruiters and alumni, a short note in your voice.

      intelligence/connect.py
      Inside

      Everything in the box, in plain words.

      Architecture

      Eleven parts. Tap one.

      The agents
      Scout

      Runs the searches and reads company job boards.

      Verifier

      Stamps a posting as real and open — or bins it.

      Analyst

      Reads each post and scores the fit.

      Connector

      Finds a way to a real person and drafts a short note.

      In the app, Discover → Agents shows nine agents as characters in a 3D office. Every work scene comes from a real event of your running search; break time never claims progress.

      Use cases · example people

      Four ordinary problems. Four real answers.

      Fresher · Hyderabad

      “Every post says 1–3 years. Do I even apply?”

      • Bands, not a wall: within reach · apply with a referral · stretch · out of range
      • A safety-net tab for large fresher programmes
      • A scam filter that never recommends critical hits
      Two years in · can’t relocate

      “I want to be early, not applicant #1,500.”

      • Watchlist companies checked every 4 hours
      • Chance to be seen beside every fit score
      • “Immediate joiners only” flagged when your notice is long
      Found a role elsewhere

      “I already have the link.”

      • Paste a description or link — get a resume, CV, cover letter, or all three
      • Paste a company job link and the agent applies; watch it or take over
      Wants a person, not a portal

      “Who do I actually talk to?”

      • The email a post itself lists — never a guessed one
      • Search links to recruiters, the hiring team and alumni; you pick the person
      • A referral pack: job link and ID, three lines to paste, one proof link
      Real screenshots, from the repository

      No mock-ups. This is the app.

      Download · desktop app

      Take it home.

      Install it like any app. Everything runs on your computer, and new versions offer to install themselves.

      Windows installer

      64-bit · no admin rights needed

      Download .exe

      .msi package

      1. Run JobHunterX_windows_x64-setup.exe.
      2. Follow the installer — it installs for your user only.
      3. Open JobHunterX. Paste a free AI key, or press Start free.
      4. Not code-signed yet, so Windows may say “Windows protected your PC”. Only for the file from the official kvcops/JobHunterX release: More info → Run anyway.

      Buttons always fetch the newest release · Release notes ↗ · All versions ↗

      Run from source

      Two lines. Then one command.

      Never used a terminal? Fine. Copy, paste, press Enter. A script does the rest.

      1. Open a terminal

        Press Start, type PowerShell, open it.

      2. Copy the project and step inside

        PS> git clone https://github.com/kvcops/jobhunterx.git
        PS> cd jobhunterx
      3. Start it

        PS> powershell -ExecutionPolicy Bypass -File start.ps1

        Or double-click start.bat in the folder. The bypass applies to this one run only.

      4. Let the first run set itself up

        It installs uv, makes a private environment, installs packages (about 30 seconds), creates the settings file, checks everything loads, and opens the app in your browser.

      5. Add a free AI key — or don’t

        The first screen shows where to get a free key, tests it and saves it. Google AI Studio is easiest; NVIDIA, Groq and Mistral work too. No key? Start free uses Kilo’s free models — marked as possibly training on your prompts, which include your resume text.

      6. Use, stop, restart

        The app lives at http://127.0.0.1:9000 — on your own computer. Stop: Ctrl + C. Next time, run the same start command.

      By hand, step by step

      1 · Install uv

      PS> powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

      2 · Virtual environment

      PS> uv venv --python 3.11
      PS> .venv\Scripts\Activate.ps1

      3 · Packages, then start

      PS> uv pip install -r requirements.txt
      PS> cd jobhunterx
      PS> python -m jobhunterx.api.main
      If something goes wrong
      Resume upload keeps loadingNo real AI key. Restart; the first screen asks for one.
      uv not foundReopen the terminal, or pip install uv.
      No module named jobhunterxRun from the inner jobhunterx folder with the venv on.
      Port 9000 busySet PORT=9001 in jobhunterx/.env, open http://127.0.0.1:9001.
      Auto-apply can’t open a browserInstall Google Chrome.
      Searches are slowAdd a second free key. Free plans allow few calls a minute.
      Straight answers

      Privacy, limits, and the fine print.

      Where your data lives

      On your computer — the desktop app’s own folder, or a local database from source. No JobHunterX account, no JobHunterX cloud.

      What leaves it

      Resume and job-post text go to the AI provider you choose. Kilo’s free models may train on prompts — add any free key and turn Kilo off in Settings if that matters.

      Limits

      Free AI plans allow few calls a minute. CAPTCHAs and logins may need you. Installers aren’t signed yet. No tool can promise interviews.

      Who it’s for

      Job seekers in India. The watchlist covers Hyderabad, Bengaluru and remote India today. Sharpest for 0–3 years of experience.

      What exactly is JobHunterX?

      An app on your computer for the whole job search: it understands your resume and goals, finds real openings, explains fit and chance to be seen, writes honest documents, fills applications with a browser agent you can take over, and tracks everything.

      Is it free? Is the code open?

      Yes and yes — MIT licensed, all of it on GitHub. It uses AI providers’ free tiers; their limits can change.

      Does it apply to every job automatically?

      No. Searching runs on its own; Auto-apply starts when you press it on a job you chose. You watch live and can stop, take over, or finish and mark it submitted yourself.

      What about logins and CAPTCHAs?

      The application shows “needs you”. Take over, click and type in the live view, press Continue. Progress is saved.

      Do I need an AI API key?

      Not strictly — “Start free” works with no key. A free Google AI Studio key is the easy private option.

      Windows, macOS, Linux?

      Installers: Windows 10/11 x64, macOS 11+ Apple Silicon, Linux x86-64 (AppImage, .deb, .rpm). Other machines can run from source.

      How is it different from job alerts?

      Alerts forward keywords. JobHunterX checks a post is real and open, reads it, applies hard checks, explains the score, estimates your chance of being seen, and goes to employers’ own boards first.

      Does it guarantee interviews?

      No. It helps you send fewer, better-fitted applications, earlier, with honest documents.