Mini ATS in Python

Purpose

The primary goal of this Python program is to provide an Applicant Tracking System (ATS) percent score by comparing the content of resumes (in the 'resumes' folder) to job description text files (in the 'jds' folder). The program utilizes keyword extraction to calculate the similarity percentage between the keywords in resumes and job descriptions.

Features

Reads both Microsoft Word (.docx, .doc) and plain text (.txt) files.
Utilizes keyword extraction to identify important terms in the documents.
Calculates the similarity percentage between resume and job description keywords.
Displays the results with color-coded output for better visibility.

How to Use

Create a folder named resumes.
- This folder will contain all the MS Word documents representing resumes.
Create a folder named jds.
- This folder will contain all the job description text files in .txt format.
Place all your MS Word documents (in .docx or .doc format) representing resumes in the resumes folder.
Place all your job description text files (in .txt format) in the jds folder.
Install dependencies using the following command:
```
pip install -r requirements.txt
```
Run the program using main.py:
```
python main.py
```

Requirements

Python 3.x
Dependencies listed in requirements.txt

File Structure

resumes: Contains all the resumes in either Word or plain text format.
jds: Contains all the job description text files.

Functions

`read_text_from_file(file_path)`

Reads and returns the text content from a text file.

`read_word_document(file_path)`

Reads and returns the text content from a Microsoft Word document.

`get_word_files(directory_path)`

Gets all MS Word files from a specified directory.

`get_text_files(directory_path)`

Gets all text files from a specified directory.

`calculate_similarity_percentage(list1, list2)`

Calculates and returns the percentage of similarity between two lists of strings.

`showIt(path, jd, sim)`

Displays the results with color-coded output based on the similarity percentage.

`init()`

A placeholder function to initialize the program.

Output Legend

Green: Similarity > 50%
Yellow: 40% <= Similarity <= 50%
Red: Similarity < 40%

Note

Ensure that the 'resumes' and 'jds' folders contain the relevant files before running the script.
To use exclusive mode where you want to consider only one JD file, add an _ before the file only. The program will skip all jds except for that file.

Feel free to customize the program according to your specific needs.

Sunilrai486 / mini_ats