Metadata-Version: 2.4
Name: job-finder-ai
Version: 0.1.3
Summary: Autonomous career agent, ATS resume tailor, and job search copilot.
Author-email: Akhil Baja <akhilbaja.work@gmail.com>
License: MIT
Project-URL: Homepage, https://github.com/AkhilBaja3005/job-finder
Project-URL: Repository, https://github.com/AkhilBaja3005/job-finder.git
Keywords: job-search,ats-resume-tailor,browser-use,career-agent,mcp-server,playwright
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: fastapi>=0.100.0
Requires-Dist: uvicorn>=0.23.0
Requires-Dist: pydantic>=2.0.0
Requires-Dist: pypdf>=3.15.0
Requires-Dist: python-docx>=0.8.11
Requires-Dist: playwright>=1.40.0
Requires-Dist: google-genai>=0.1.0
Requires-Dist: google-api-core>=2.11.0
Requires-Dist: python-dotenv>=1.0.0
Requires-Dist: jinja2>=3.1.0
Requires-Dist: beautifulsoup4>=4.12.0
Requires-Dist: python-multipart>=0.0.6
Requires-Dist: pyyaml>=6.0
Requires-Dist: browser-use>=0.1.0
Provides-Extra: supabase
Requires-Dist: httpx>=0.24.0; extra == "supabase"
Provides-Extra: huggingface
Requires-Dist: huggingface-hub>=0.20.0; extra == "huggingface"
Provides-Extra: anthropic
Requires-Dist: anthropic>=0.18.0; extra == "anthropic"
Provides-Extra: groq
Requires-Dist: groq>=0.4.0; extra == "groq"
Provides-Extra: cloud
Requires-Dist: httpx>=0.24.0; extra == "cloud"
Requires-Dist: huggingface-hub>=0.20.0; extra == "cloud"
Provides-Extra: dev
Requires-Dist: pytest>=7.4.0; extra == "dev"
Requires-Dist: pyright>=1.1.300; extra == "dev"
Requires-Dist: sentry-sdk>=1.30.0; extra == "dev"
Provides-Extra: all
Requires-Dist: httpx>=0.24.0; extra == "all"
Requires-Dist: huggingface-hub>=0.20.0; extra == "all"
Requires-Dist: anthropic>=0.18.0; extra == "all"
Requires-Dist: groq>=0.4.0; extra == "all"
Requires-Dist: sentry-sdk>=1.30.0; extra == "all"
Requires-Dist: pytest>=7.4.0; extra == "all"
Requires-Dist: pyright>=1.1.300; extra == "all"
Dynamic: license-file

# Job Finder AI 💼

[![Python](https://img.shields.io/badge/Python-3.10%2B-blue?logo=python&logoColor=white)](https://www.python.org/)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![MCP](https://img.shields.io/badge/Protocol-Model%20Context%20Protocol%20(MCP)-purple)](https://modelcontextprotocol.io/)

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

Install the package directly from PyPI:

```bash
pip install job-finder-ai
```

Or install with all cloud & database integrations:

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

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

```bash
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:

```bash
job-finder setup
```

The wizard will:
- Initialize your local `.env` configuration template.
- 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:

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

# Autonomous mode (Submits applications directly):
job-finder scan --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:

```bash
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:

```bash
# 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. Local Web Server & Dashboard (`job-finder server`)
Launch the backend server locally on port 8000:

```bash
job-finder server --port 8000
```

### 5. Model Context Protocol Server (`job-finder mcp`)
Launch the stdio MCP server for integration with **Cursor IDE**, **Claude Code**, **Claude Desktop**, and **Antigravity**:

```bash
job-finder mcp
```

---

## ⚙️ 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 (or iCloud Drive Red tag) |

---

## 📄 License

MIT License. Designed and maintained by [Akhil Baja](https://github.com/AkhilBaja3005).
