Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/swarajkumarsingh/ats-project
Free & Open Source ATS HR Portal with simple user friendly interface. With built-in features like Email Notifcation, Google Meet Call Scheduling & Google Calendar Event using Python with the support of Gemini & ChatGPT
https://github.com/swarajkumarsingh/ats-project
ats hr-portal python reusme streamlit
Last synced: 5 days ago
JSON representation
Free & Open Source ATS HR Portal with simple user friendly interface. With built-in features like Email Notifcation, Google Meet Call Scheduling & Google Calendar Event using Python with the support of Gemini & ChatGPT
- Host: GitHub
- URL: https://github.com/swarajkumarsingh/ats-project
- Owner: swarajkumarsingh
- License: mit
- Created: 2024-09-11T07:40:44.000Z (5 months ago)
- Default Branch: main
- Last Pushed: 2024-12-21T07:39:17.000Z (about 2 months ago)
- Last Synced: 2024-12-21T08:28:23.440Z (about 2 months ago)
- Topics: ats, hr-portal, python, reusme, streamlit
- Language: Python
- Homepage: https://github.com/swarajkumarsingh/ats-project
- Size: 8.38 MB
- Stars: 1
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: Readme.md
- License: LICENSE
Awesome Lists containing this project
README
# Advanced ATS System
Welcome to the **Advanced ATS System**, a personal project designed to streamline the resume screening process. This tool evaluates resumes against predefined job descriptions and ATS criteria, offering an intuitive and feature-rich interface for recruiters. Also supports both Gemeini & ChatGPT for it's calculations and saves the scheduled interview to google calender
## Features
### 1. **Job Description and Criteria Input**
- **Text Area for Job Descriptions**: Input detailed job descriptions to define the requirements for the position.
- **Set Experience Requirements**:
- Minimum Years of Experience: Define the least experience required for the role.
- Maximum Years of Experience: Set the upper limit of experience suitable for the role.
- **ATS Score Criteria**: Set a difficulty level for filtering resumes based on ATS scores (0 to 100).
---
### 2. **Resume Uploads**
- **Upload Multiple Resumes**: Drag and drop or select multiple resumes in **PDF** or **DOCX** format.
- **Validation and Feedback**: Each resume is validated and categorized as *Accepted* or *Rejected* based on ATS criteria.
---
### 3. **Resume Processing**
- **Score Resumes**: Automatically calculate the ATS score for each resume using the provided job description and criteria.
- **Rejection Feedback**: Clear reasons for rejection (e.g., score below criteria, missing key information like name or email).
- **Approval Notifications**: Resumes that meet the ATS criteria are marked as *Passed*.
---
### 4. **Candidate Information Extraction**
- Extract **Name**, **Email**, and **Phone Number** from the resume for successful candidates.
- Validation for missing critical details like name or email, ensuring quality processing.
---
### 5. **AI-Powered ATS Scoring**
- **Supports Gemini and ChatGPT Models**:
Leverage the power of **Gemini** and **ChatGPT** for enhanced AI-driven resume analysis and ATS scoring. You can easily switch between these models based on your preference or use case.
---
### 6. **Email Notifications**
- **HR Notification**:
- Receive a CSV file with details of all shortlisted candidates via email.
- Email includes key candidate details and their ATS scores.
- **Candidate Notifications**:
- Shortlisted candidates receive an email informing them of their selection.
---
### 7. **Export and Download**
- **ZIP File of Shortlisted Resumes**: Download all shortlisted resumes in a single ZIP file for easy access.
- **CSV Export**: Export detailed candidate information (name, email, phone, ATS score) in CSV format.
---
### 8. **Debug Logs**
- **Debugging Made Easy**: Expandable debug logs display key details of the resume processing pipeline for transparency.
---
## How to Use
1. **Set Job Criteria**:
- Enter the job description, minimum and maximum experience, and ATS score criteria.
2. **Upload Resumes**:
- Drag and drop resumes in PDF or DOCX format into the upload section.
3. **Process Resumes**:
- Click "Process Resumes" to evaluate uploaded resumes.
4. **Download Results**:
- Download a ZIP of shortlisted resumes or a CSV with candidate details.
5. **Email Notifications**:
- Receive a compiled CSV of successful candidates.
- Shortlisted candidates receive personalized email notifications.
---
## Project Structure
```
project/
│
├── main.py # Core application logic
├── utils.py # Utility functions for processing resumes and files
├── email_service.py # Email handling for notifications
├── .env # Environment variables (API keys, email config)
└── README.md # Project documentation
```
---
## Dependencies
Make sure you have the following libraries installed:
- **Python 3.9+**
- **Streamlit** (for the web interface)
- **dotenv** (for environment variable management)
- **io** (for handling string inputs/outputs)
- **Custom modules** (`utils`, `email_service`)
Install all dependencies using:
```bash
pip install -r requirements.txt
```
---
## Configuration
1. Create a `.env` file with the following variables:
```
SMTP_SERVER=smtp.example.com
SMTP_PORT=587
[email protected]
SMTP_PASSWORD=your_email_password
GEMINI_API_KEY=your_key
OPENAI_API_KEY=your_key
AWS_BUCKET_NAME=your_aws_bucket_name
AWS_SES_FROM_EMAIL_ID=your_aws_ses_from_email
```
2. Adjust any custom configurations in `email_service.py` and `utils.py` as needed.
---
## Run the Application
Start the application using Streamlit:
```bash
streamlit run main.py
```
Visit the app in your browser at `http://localhost:8501`.
---
## Future Enhancements
- **AI-Based Resume Scoring**: Use ML models to improve the scoring process.
- **Integration with Job Boards**: Automate resume collection directly from platforms like LinkedIn or Naukri.
- **Admin Dashboard**: Add analytics for processed resumes and ATS performance.
---
## **Application Workflow**
## **Overview**
This document details the automated workflow for processing candidate resumes through the ATS (Applicant Tracking System). The system is engineered to efficiently extract and evaluate candidate data, executing a series of sophisticated actions when the candidate's ATS score surpasses 75%.
---
## Workflow Steps
1. **Initial Scoring:**
- The ATS application processes each candidate's resume.
- Calculate the candidate's ATS score based on the match between the resume, job description and ats score.
2. **Conditional Check:**
- **If Candidate's ATS Score > 75%:**
- Proceed with the following steps.
- **Else:**
- No further action is taken for this candidate.
3. **Data Extraction:**
- Extract the following details from the candidate's resume:
- **Candidate's ATS Score**: The calculated score indicating how well the resume matches the job description.
- **Candidate's Email**: The email address provided by the candidate.
- **Candidate's Name**: The full name of the candidate.
- **Candidate's Phone Number**: The contact phone number listed on the resume.
4. **Email Notifications:**
- **To HR:**
- Send an email containing the candidate's ATS score, name, email, and phone number.
- **To Candidate:**
- Send an email informing the candidate about the outcome and next steps.
5. **Google Calendar Event:**
- Set up a Google Calendar event for the candidate.
- Send the event invitation to both the candidate and HR.
6. **Download processed resumes button:**
- Download the list of passed candidates in zip format.
### Contact
For queries, suggestions, or contributions, feel free to reach out:
- **Email**: [email protected]
- **Linkedin**: https://in.linkedin.com/in/swarajkumarsingh
### Happy Recruiting!