# JustHireMe

> A local-first desktop workbench that scrapes job leads, ranks your fit and drafts tailored applications

- Category: Agents & Automation / Assistants & Chatbots
- Language: Python
- Licence: AGPL-3.0
- Repository: https://github.com/vasu-devs/JustHireMe
- Website: https://www.justhireme.ai
- Canonical page: https://ai-tldr.dev/tools/justhireme/
- Updated: 2026-09-01

## In short

JustHireMe is a local-first desktop workbench for job hunting. It sits in the Assistants & Chatbots category of the Agents & Automation tools and is open-source, written in Python and licensed AGPL-3.0. To get started: install the desktop app.

## Overview

JustHireMe is a local-first desktop workbench for job hunting. It collects leads from ATS and company boards, RSS feeds, Hacker News, GitHub, Reddit and other configured sources, rejects stale, thin, spammy or senior-only postings with a deterministic quality gate, ranks what remains against your profile, and generates a tailored resume PDF, cover letter PDF and outreach drafts for the roles worth pursuing. Profile data, lead history, generated documents, the graph, vectors and settings stay on your machine by default.

Ranking is meant to be explainable rather than a black-box score. It combines source signal, lead quality, a deterministic fit rubric, seniority caps, project and stack evidence, semantic similarity and feedback learning, with optional LLM evaluation on top. Your resume is turned into a Kùzu graph of skills, roles and projects plus LanceDB vectors, so a fit score comes with GraphRAG proof from your own experience. Embeddings use a bundled ONNX model (`all-MiniLM-L6-v2`), so semantic matching works offline without an API key.

The app is a Tauri 2 shell around a React UI and a Python FastAPI sidecar, with installers for Windows, macOS and Linux that update themselves from GitHub releases. LLM steps can run keyless through Ollama or an existing Claude Code or Codex CLI subscription, or through keyed providers such as OpenAI, Anthropic, Gemini, Groq and DeepSeek. It is field- and location-agnostic, and a stdio MCP server exposes fit scoring, the lead-quality gate and lead extraction to other agents. Browser automation and auto-apply code exists but is experimental and disabled by default — generated material is a draft for you to review, not a submission.

## What it does

- Source adapters for ATS boards, RSS/Atom, Hacker News, GitHub, Reddit, custom JSON and a Playwright web fallback, normalised and deduplicated into a local CRM
- A deterministic quality gate that filters stale, thin, senior-only, unpaid or context-free postings and records the reason
- Explainable fit ranking backed by a Kùzu profile graph, LanceDB vectors and local ONNX embeddings, with optional LLM evaluation
- Tailored resume and cover letter PDFs plus founder message, LinkedIn note and cold email drafts, with keyword coverage and selected-project rationale
- Keyless LLM options (Ollama, Claude Code CLI, Codex CLI) alongside 15+ keyed providers
- An MCP server exposing `score_job_fit`, `evaluate_lead_quality` and `extract_lead_intel`, and an agent-neutral skill file

## Getting started

Non-developers install the desktop app from GitHub Releases; contributors run it from source with Node.js 24, Python 3.13+, Rust and uv.

1. Install the desktop app

   Download the asset for your platform from the project's GitHub Releases page:`JustHireMe_*_x64-setup.exe` on Windows, `JustHireMe_*_aarch64.dmg` on Apple Silicon, or the `.deb` / AppImage on Linux. Windows and macOS builds are not yet signed or notarized, so you may need More info → Run anyway or Open Anyway. The first launch downloads a one-time runtime pack (browser, vector libraries and embedding model).

```bash
sudo dpkg -i JustHireMe_*_amd64.deb      # Debian/Ubuntu
chmod +x JustHireMe_*_amd64.AppImage      # or the portable AppImage
```

2. Or run the full desktop app from source

   This starts the Tauri shell, the frontend and the Python backend sidecar.

```bash
git clone https://github.com/vasu-devs/JustHireMe.git
cd JustHireMe
npm ci
cd backend
uv sync --dev
cd ..
npm run tauri dev
```

3. Import your profile and scan

   Import a resume (PDF, DOCX, TXT, MD, JSON Resume, LinkedIn export, GitHub or portfolio URL), describe the role you want, then scan sources and review the ranked leads in the pipeline. API keys for keyed LLM providers are set inside the app; Ollama or a Claude Code / Codex CLI subscription work without one.

4. Expose it to other agents over MCP

   After `uv sync --dev`, point an MCP client at the backend's server script (on Windows use `backend\.venv\Scripts\python.exe`).

```json
{
  "mcpServers": {
    "justhireme": {
      "command": "/absolute/path/to/JustHireMe/backend/.venv/bin/python",
      "args": ["/absolute/path/to/JustHireMe/backend/mcp_server.py"],
      "cwd": "/absolute/path/to/JustHireMe"
    }
  }
}
```

## When to use it

- Replace scrolling several job boards with one local shortlist that has stale and spammy postings already filtered out
- See why a role scores well against your experience before spending time on an application
- Draft a tailored resume, cover letter and outreach message for a role while keeping your personal data off third-party servers
- Give another agent job-fit scoring and lead-quality checks through MCP

## Version history

- 2026-09-01 v1.7.0: v1.7.0 shipped Windows, macOS and Linux installers built by GitHub Actions, with SHA256 checksums for every asset and the runtime packs.
