Skip to content

Repository files navigation

Job Application AI Agent

An intelligent AI-powered tool that automates the job application process by:

  1. Scraping job listings from platforms like LinkedIn
  2. Analyzing job descriptions to extract key requirements
  3. Automatically tailoring your CV to match job requirements
  4. Generating customized cover letters

Features

  • Job Scraping: Automatically search and collect job listings from LinkedIn
  • Intelligent Analysis: Extract key skills and requirements from job descriptions
  • CV Customization: Tailor your CV to highlight relevant skills for each job
  • Batch Processing: Generate multiple tailored CVs for different jobs at once
  • User-Friendly Interface: Simple web interface to control the entire process

Setup

Prerequisites

  • Python 3.8+
  • Chrome browser (for web scraping)

Installation

  1. Clone this repository:
git clone https://github.com/yourusername/Job-apply-AI-agent.git
cd Job-apply-AI-agent
  1. Run the installation script:
# On Unix-based systems (macOS, Linux)
./install.sh

# On Windows
install.bat

This will:

  • Create a virtual environment
  • Install all dependencies
  • Download the required spaCy language model
  • Install the package in development mode

Usage

Web Interface

  1. Start the web interface:
# Activate the virtual environment first
source venv/bin/activate  # On Unix-based systems
venv\Scripts\activate.bat  # On Windows

# Start the web app
job-apply-ai web
  1. Open your browser and go to: http://localhost:5000

  2. Upload your base CV template

  3. Search for jobs by entering a job title and location

  4. Generate tailored CVs for all jobs or for specific jobs

Command Line

The application also provides a command-line interface:

# Scrape job listings
job-apply-ai scrape --keyword "Software Engineer" --location "Berlin" --max-jobs 5

# Generate tailored CVs for all jobs in an Excel file
job-apply-ai batch --cv path/to/cv_template.docx --jobs-file path/to/jobs.xlsx

# Generate a tailored CV for a single job description
job-apply-ai tailor --cv path/to/cv_template.docx --job path/to/job_description.txt

Project Structure

  • job_apply_ai/scraper/: Job listing scraping modules
  • job_apply_ai/cv_modifier/: CV customization functionality
  • job_apply_ai/utils/: Utility functions and helpers
  • job_apply_ai/ui/: User interface components
  • job_apply_ai/outputs/: Output directories for jobs and CVs
    • job_apply_ai/outputs/jobs/: Contains Excel files with job listings
    • job_apply_ai/outputs/cvs/: Contains generated CV files

Testing

For detailed testing instructions, see TESTING_GUIDE.md.

License

MIT

Contributing

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

About

GitHub Project: AI Job Application Automation 🚀 This project automates job searching, CV creation, and applications using Python, n8n, Selenium, and OpenAI. It scrapes LinkedIn, Indeed, StepStone, generates a custom CV & cover letter, and auto-applies to jobs. Integrated with Google Sheets/Airtable & Email alerts.

Resources

Stars

179 stars

Watchers

5 watching

Forks

Releases

Packages

Used by

Contributors

Languages