<div align="center">

<img src="assets/logo.jpg" width="200" alt="JobPilot Logo" style="border-radius: 20px;" />

# JobPilot ✈️

![JobPilot Banner](https://img.shields.io/badge/JobPilot-AI_Career_Co--Pilot-blue?style=for-the-badge&logo=openai)

[![Next.js](https://img.shields.io/badge/Next.js-14-black?style=flat-square&logo=next.js)](https://nextjs.org/)
[![FastAPI](https://img.shields.io/badge/FastAPI-0.109-009688?style=flat-square&logo=fastapi)](https://fastapi.tiangolo.com/)
[![MCP](https://img.shields.io/badge/MCP-Ready-green?style=flat-square)](https://github.com/model-context-protocol)
[![License](https://img.shields.io/badge/License-MIT-yellow.svg?style=flat-square)](LICENSE)

**Your Intelligent AI Agent for Career Success**
*Automated Job Search, Resume Optimization, and Application Management*

[Features](#-features) • [Architecture](#-architecture) • [Getting Started](#-getting-started) • [Roadmap](#-roadmap)

[English](README.md) | [中文](README_CN.md) | [日本語](README_JP.md) | [한국어](README_KR.md) | [Français](README_FR.md) | [Deutsch](README_DE.md)

</div>

---

## 📖 Introduction

**JobPilot** is a next-generation career assistant powered by **AI Agents** and the **Model Context Protocol (MCP)**. It acts as your personal recruiter, tirelessly searching for jobs on platforms like LinkedIn, optimizing your resume for specific job descriptions (JD), and even automating the application process.

Designed for the age of AI, JobPilot exposes a full MCP server, allowing you to connect it with your favorite AI assistants (like Claude Desktop, OpenClaw, or custom agents) to handle your job hunt autonomously.

> **Why JobPilot?**
> Instead of manually tweaking your CV for every application, let JobPilot's agents analyze the JD, rewrite your resume to highlight relevant skills, and submit the application for you—while you sleep.

<a href="https://glama.ai/mcp/servers/arthurpanhku/job-pilot">
  <img width="380" height="200" src="https://glama.ai/mcp/servers/arthurpanhku/job-pilot/badge" alt="job-pilot MCP server" />
</a>

![JobPilot Dashboard](assets/dashboard-preview.jpg)

<video src="assets/grok-video-demo.mp4" controls="controls" style="max-width: 100%;">
</video>

## ✨ Features

### 🤖 MCP-Native Architecture
- **Agent-First Design**: Built from the ground up as a Model Context Protocol (MCP) server.
- **Universal Compatibility**: Connects seamlessly with any MCP-compliant client (Claude, IDEs, Agent frameworks).

### 📄 Intelligent Resume Engine
- **Context-Aware Optimization**: Analyzes your master profile against target JDs to generate hyper-personalized resumes.
- **ATS Friendly**: Ensures generated resumes are optimized for Applicant Tracking Systems.

### 🕵️ Automated Job Hunter
- **Smart Search**: Scrapes and filters job listings from LinkedIn and Indeed based on your semantic profile.
- **Auto-Apply**: Automated form filling with built-in stealth mode and anti-detection mechanisms (human-like delays, randomized user agents).
- **Risk Reduction**: "Safe Mode" with dry-run capability and manual confirmation steps to avoid account flags.

### 📊 Application Tracking
- **Dashboard**: Modern UI built with Shadcn components to visualize your application status, interview pipeline, and success rates.
- **History**: Keep a record of every tailored resume version sent to recruiters.

## 🛠️ Tech Stack

- **Frontend**: 
  - [Next.js 14](https://nextjs.org/) (App Router)
  - TypeScript
  - Tailwind CSS & Lucide Icons
- **Backend**: 
  - [FastAPI](https://fastapi.tiangolo.com/) (Python)
  - Pydantic
  - MCP SDK (Python)
- **Automation & AI**:
  - Playwright (Browser Automation)
  - OpenAI / Anthropic APIs (LLM)
  - Supabase (Database & Auth)

## 🚀 Getting Started

### Prerequisites
- Node.js 18+
- Python 3.11+
- Git

### Installation

1. **Clone the repository**
   ```bash
   git clone https://github.com/yourusername/job-pilot.git
   cd job-pilot
   ```

2. **Backend Setup**
   ```bash
   cd backend
   python -m venv venv
   source venv/bin/activate  # On Windows: venv\Scripts\activate
   pip install -r requirements.txt
   
   # Start the API & MCP Server
   python app/main.py
   ```

3. **Frontend Setup**
   ```bash
   cd frontend
   npm install
   
   # Start the UI
   npm run dev
   ```

4. **Access the App**
   - Frontend: `http://localhost:3000`
   - API Docs: `http://localhost:8000/docs`

## 🗺️ Roadmap

- [x] Project Initialization & Architecture Design
- [ ] **Phase 1**: MCP Server Implementation & Basic Profile Management
- [ ] **Phase 2**: LinkedIn Scraper Integration & Job Matching
- [ ] **Phase 3**: Resume Optimization Pipeline (LLM)
- [ ] **Phase 4**: Automated Application via OpenClaw/Playwright

## 🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

## 🌟 Star History

[![Star History Chart](https://api.star-history.com/svg?repos=arthurpanhku/job-pilot&type=Date)](https://star-history.com/#arthurpanhku/job-pilot&Date)

## 📄 License

This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.