⚡ JobAgent - Autonomous Multi-Platform AI Job Application Agent

An autonomous AI agent designed to search, evaluate, match technical skills, dynamically fill application forms, and submit job applications across LinkedIn Easy Apply and Naukri.com Quick Apply.

Equipped with a Web UI Control Center, Interactive Conversational AI Chat, ATS Resume Reviewer, Multi-Page Pagination, and Strict Technical Skill Matching.

📌 IMPORTANT NOTES FOR NEW USERS (READ BEFORE FIRST RUN)

🚀 Quick Start (Under 60 Seconds)

1. Install via pip

pip install --upgrade jobagent

2. Launch JobAgent

Run in any terminal (PowerShell, Command Prompt, macOS/Linux Terminal):

jobagent

On your first run:

1. JobAgent guides you through an onboarding wizard to configure your resume, target roles, location, and CTC preferences.
2. Select Option [1] to log into your LinkedIn / Naukri accounts once.
3. Select Option [2] to start applying, Option [5] to launch the Web UI Dashboard, or Option [3] to chat with the agent!

🎮 Interactive Menu Options

When you run jobagent, you are greeted with the interactive assistant:

=====================================================
           AI Job Application Agent CLI              
  Autonomous Multi-Platform Applications: LinkedIn & Naukri 
=====================================================

What would you like to do?
  [1] 🔑 Sign In / Verify Platform Accounts (Save LinkedIn & Naukri login permanently)
  [2] 🚀 Direct Apply to Jobs (LinkedIn, Naukri, or Both)
  [3] 💬 Chat with Agent (Search & apply, update details, ask questions)
  [4] 📋 View All Applied Jobs (Full history, links & status)
  [5] 🖥️  Launch Professional Web UI Dashboard
  [6] 📄 Run AI ATS Resume Review & Gap Analysis
  [7] ✏️  Edit Candidate Profile & Preferences
  [8] 📎 Update Resume PDF
  [9] 📊 View Session History & Memory Rules
  [0] 🚪 Exit

💻 CLI Command Line Shortcuts

You can also run specific modes directly via CLI flags:

🧠 Core Architecture Highlights

1. Strict Technical Skill Matching & Incompatible Stack Gate

• 50% Technical Skills | 30% Experience Fit | 20% Role Relevance.
• Detects incompatible programming languages and frameworks (e.g. skips Python/C# postings if candidate's core stack is Java/Selenium/Playwright).
• Requires at least 50% technical match before proceeding; non-matching posts are automatically skipped and logged with clear reasoning.

2. LinkedIn Multi-Page Search Pagination & Query Precision

• Supports paginating across pages (start=0, 25, 50, 75...) to process up to 100+ job applications.
• Enriches short queries (e.g. expanding "QA" to '"QA" OR "Quality Assurance" OR "SDET" OR "Test Automation"') to eliminate irrelevant postings.
• Deep scrolling ensures up to 25 job cards per page are extracted.

3. Dynamic Form Filling & Memory Engine

• Traverses multi-step Easy Apply and Quick Apply modals.
• Intelligently maps text fields, dropdowns, radio buttons, numbers, and resume uploads.
• Remembers previously answered employer questions (e.g., notice period, CTC, work authorization) in local memory so you never answer the same question twice.

4. Human-in-the-Loop (HITL) Gate

• Pause before submitting each job application to inspect candidate CTC, notice period, and match breakdown, or enable Auto-Apply for 100% autonomous operation.

🛠️ Troubleshooting & FAQs

Q: Why is LinkedIn asking for login again?

Run Option [1] 🔑 Sign In / Verify Platform Accounts (or jobagent --signin). Sign into LinkedIn completely in the open browser. Once verified, session cookies are saved to .browser_context/ and persist indefinitely across all future runs.

Q: What happens if LinkedIn prompts for 2FA or CAPTCHA?

JobAgent detects security challenges, pauses automation, and displays an alert in the console. You can approve the prompt on your mobile LinkedIn app or solve the CAPTCHA in the open browser. The agent automatically detects verification and resumes where it left off.

Q: How do I change my target location, role, or CTC?

• Select Option [7] ✏️ Edit Candidate Profile & Preferences from the interactive menu.
• Or select Option [8] 📎 Update Resume PDF to upload an updated resume.

Q: Do I need an OpenAI or Gemini API Key?

An API key is optional. If you supply GEMINI_API_KEY or OPENAI_API_KEY, JobAgent uses LLM semantic reasoning. If left empty, JobAgent's built-in offline NLP heuristics perform deterministic extraction and matching automatically.

📄 License

MIT License. Created & maintained by Yaswanth Asapu.