Skip to main content
Loss of provenance

A previous release had provenance metadata, but this release does not. View details.

Job Finder AI 💼

Python License: MIT MCP

Production-grade autonomous career agent, ATS resume tailor, and job application copilot.

Upload your resume once, and let Job Finder AI:

  1. Concurrently search Greenhouse, Ashby, Lever, LinkedIn, Indeed, and Reed for fresh job postings.
  2. Calculate deterministic ATS match scores against your candidate profile.
  3. Automatically tailor pixel-perfect 1-page LaTeX resumes when required.
  4. Autonomously fill out web application forms via browser automation (browser-use).

⚡ Quick Start & Installation

1. Create & Activate Virtual Environment (Windows PowerShell)

# Create a virtual environment
python -m venv venv

# Activate the virtual environment in PowerShell
.\venv\Scripts\Activate.ps1

(On macOS/Linux: python3 -m venv venv && source venv/bin/activate)

2. Install Package

Install the package directly from PyPI:

pip install job-finder-ai

Or install with all cloud & database integrations:

pip install "job-finder-ai[all]"

Playwright browser dependencies (for browser auto-fill & web scraping):

playwright install chromium

🚀 Setup Wizard (job-finder setup)

Run the interactive setup wizard to configure your .env, import your master resume, and review your candidate profile:

job-finder setup

The wizard will:

  • Initialize your local .env configuration template with safe local defaults (BROWSER_USE_HEADLESS=false, JOB_FINDER_DISABLE_GUARDRAILS=0).
  • Prompt for your Gemini API Key (required for LLM reasoning and resume parsing).
  • Prompt whether you want to configure Email Notifications (Optional): if enabled (y), it asks for your sender email and SMTP App Password so you receive automated email confirmations when applications are submitted, and alerts if an application requires manual review.
  • Auto-detect and parse your master resume (.pdf / .docx / .tex).
  • Verify demographic, work authorization, and portal fields, interactively prompting for any missing details.

🛠️ Unified CLI Commands

1. Autonomous Job Discovery & Tailoring Scanner (job-finder scan)

Search job boards, score postings against your candidate profile, tailor resumes, and auto-apply:

# Preview mode (Safety Guardrails active — reviews before submission):
job-finder scan

# Autonomous mode (Submits applications directly):
job-finder scan --auto-apply

# Apply directly to LinkedIn Top Applicant postings without JD scoring:
job-finder scan --top-applicant

# Auto-apply directly to all LinkedIn Top Applicant postings:
job-finder scan --top-applicant --auto-apply

# Direct single-URL application:
job-finder scan "https://boards.greenhouse.io/company/jobs/12345" --auto-apply

# Advanced tuning (timeouts, steps, ATS thresholds, roles, freshness):
job-finder scan --role "AI Systems Engineer" --location "London, UK" --timeframe "24h" --min-ats 70 --timeout 180 --auto-apply

2. Direct Application Autofill (job-finder apply)

Run ad-hoc browser auto-filler on any specific job application URL:

job-finder apply "https://jobs.ashbyhq.com/company/abc-123" --submit

3. Candidate Profile Management (job-finder profile)

Inspect or re-sync your candidate background from your resume:

# View active candidate profile & preferences:
job-finder profile --show

# Re-sync profile from a new resume PDF:
job-finder profile --sync /path/to/resume.pdf

4. System Status & Health Check (job-finder status)

Display system health, environment status, API key configuration, master resume path, and active profile details:

job-finder status

5. Standalone ATS Health Audit & AI Optimization (job-finder ats)

Run a standalone ATS audit on your master resume or candidate profile, compute keyword matches and bullet metrics ratio, and auto-optimize your summary:

# Run baseline ATS audit:
job-finder ats

# Evaluate a specific resume PDF:
job-finder ats --resume /path/to/resume.pdf

# Run audit and auto-optimize summary for ATS conversion using AI:
job-finder ats --optimize

6. Application Pipeline Tracker (job-finder tracker)

List and inspect your tracked job applications, tailored resumes, and saved roles:

# View all tracked entries:
job-finder tracker

# Filter by application status (applied, saved, tailored):
job-finder tracker --status applied --limit 10

7. Jobserve Tech & Contract Search (job-finder jobserve)

Search Jobserve for active tech, AI, software engineering, and contract/permanent roles:

# Search top Jobserve roles (UK, 48h):
job-finder jobserve "AI Engineer" --location UK --timeframe 48h

# Auto-apply to discovered Jobserve listings:
job-finder jobserve "Senior Backend Engineer" --auto-apply --limit 5

8. TargetJobs UK Graduate Search (job-finder targetjobs)

Search TargetJobs.co.uk graduate and early career tech vacancies:

job-finder targetjobs "Software Engineer" --location London --timeframe 48h

9. Local Web Server & Dashboard (job-finder server)

Launch the backend server locally on port 8000:

job-finder server --port 8000

10. Model Context Protocol Server (job-finder mcp)

Launch the stdio MCP server for integration with Cursor IDE, Claude Code, Claude Desktop, and Antigravity:

job-finder mcp

🧩 Browser Extension (Chrome & Brave)

Job Finder AI includes a lightweight Chrome/Brave browser extension for 1-click job scoring, autofill, and pipeline sync while browsing job boards:

  • Instant ATS Scoring: Inspect any active tab on Greenhouse, Ashby, Lever, or LinkedIn to instantly calculate compatibility against your master profile.
  • One-Click Autofill: Automatically populate form inputs, screening questions, and upload your resume directly from your browser toolbar.
  • Live Sync: Syncs application status seamlessly with your local CLI tracker or the cloud dashboard at job-finder.space.

Installing the Extension:

  1. Download or generate the extension ZIP from your local server or https://www.job-finder.space.
  2. In Chrome / Brave, navigate to chrome://extensions.
  3. Enable Developer mode in the top right corner.
  4. Click Load unpacked and select the extracted extension/ directory.

⚙️ Environment Variables

You can configure environment settings in a local .env file or export them directly:

Variable Description
GEMINI_API_KEY Google Gemini API Key for LLM operations & browser-use
PORTALS_PASSWORD Password for automated job board account creation
BROWSER_USE_TIMEOUT Autofill session timeout in seconds (default: 300)
TAILORING_TIMEOUT Resume tailoring timeout in seconds (default: 90)
MASTER_RESUME_PATH Path to master resume PDF

👥 Authors & Contributors


📄 License

MIT License. Designed and maintained by Akhil Baja and Bhavesh Nivas.

Metadata

Release files for job-finder-ai 1.4.7

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Loss of provenance

These files do not have provenance metadata, despite files in a prior release including this data.

We recommend further investigation before installing these files. View details.

Source distribution (sdist)

Source distribution for job-finder-ai 1.4.7
File Size Uploaded Provenance Actions
job_finder_ai-1.4.7.tar.gz 506.6 kB Without provenance Details for job_finder_ai-1.4.7.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for job-finder-ai 1.4.7
File Interpreter ABI Platform Actions
job_finder_ai-1.4.7-py3-none-any.whl Python 3 none any Details for job_finder_ai-1.4.7-py3-none-any.whl

Total release size: 1.0 MB

Release files / job_finder_ai-1.4.7.tar.gz

Loss of provenance

This file belongs to a release without provenance metadata, despite a prior release including this data.

We recommend further investigation before installing this file. View details.

Download URL job_finder_ai-1.4.7.tar.gz
Size 506.6 kB
Tags Source
SHA-256 checksum
How to use checksums
55a3e6a4e601e81212175e7f02c82ec794a8c0828450661a87b78f27fc1a02c3
BLAKE2b-256 checksum
How to use checksums
fa465bea46d54367d042635ec12beb280ff7e64a9ba655f752f8859a13570ebf
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.14.5

Release files / job_finder_ai-1.4.7-py3-none-any.whl

Loss of provenance

This file belongs to a release without provenance metadata, despite a prior release including this data.

We recommend further investigation before installing this file. View details.

Download URL job_finder_ai-1.4.7-py3-none-any.whl
Size 513.3 kB
Tags Python 3
SHA-256 checksum
How to use checksums
cfcd94d4790ad2d3cb8aaf0755a7ce9bd5916c070d953e39f4e193dbbf3e0532
BLAKE2b-256 checksum
How to use checksums
d2abd4a8ef534578bc1712d6be5f4e59fa1b5adf1774ea2b9adf26d790bb3cc7
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.14.5

Security for job-finder-ai 1.4.7

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Loss of provenance

A previous release of these files had provenance metadata, but this release does not.

While this could reflect a routine change by the project maintainers, it may also indicate that the release files have been compromised.

Release comparison

  • Removed 1.4.5 2 files With provenance
  • Added 1.4.7 2 files Without provenance

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

1.4.7 This release

2 release files Loss of provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page