README.md

---
title: CrewAI ATS Resume Screener Rewriter
emoji: 🐨
colorFrom: blue
colorTo: red
sdk: streamlit
sdk_version: 1.42.0
app_file: app.py
pinned: false
license: apache-2.0
short_description: Resume Screener Rewriter using CrewAI flow
---

# CrewAI ATS Resume Screener & Rewriter

An AI-driven system built using CrewAI to streamline both employer-side candidate screening and candidate-side resume optimization for Applicant Tracking Systems (ATS).Please find the deployed app at https://huggingface.co/spaces/sunithalv/ATSCrewAI

## 🔧 Features

### 👔 Employer Mode
- Upload a **job description** and **multiple resumes**.
- Automatically **score resumes** based on relevance.
- **Top 3 candidates** receive personalized interview invitation emails.
- Remaining candidates receive **personalized rejection emails**.
- All emails are customized based on resume and job context.

### 👤 Candidate Mode
Two available options:
1. **ATS Resume Score Check**:
   - Enter a **job URL** to evaluate your resume.
   - Get a **personalized score** with actionable feedback.

2. **Resume Rewriting**:
   - Optional: Provide a **job URL** for targeted optimization.
   - Resume is rewritten **only if the score < 85**.
   - Supports up to **2 rewrite attempts**.
   - Returns final score and **detailed feedback**.

## 🚀 Tech Stack
- **Python 3.11**
- [CrewAI](https://github.com/joaomdmoura/crewai)
- LangChain Tools
- Gmail SMTP (secured with App Passwords)
- PyMuPDF, spaCy, NLTK
- Streamlit (for UI)
- ONNX Runtime for model inference

## 📦 Installation

```bash
git clone https://github.com/sunithalv/ATS-Crewai.git

# Install dependencies using uv
uv venv  # creates a virtual environment and activates it
uv pip install -e .
```

> Note: Python version must be >= 3.11 and < 3.12

## ▶️ Run the Application

Launch the app locally using Streamlit:

```bash
streamlit run app.py
```

> The UI will open in your browser at `http://localhost:8501`

## 📧 Gmail Integration

This project sends emails using Gmail's SMTP server. You'll need to configure your environment with the following variables:

### 🔐 Environment Setup

Create a `.env` file in the root directory with:

```
EMAIL_ADDRESS=your-email@gmail.com
EMAIL_PASSWORD=your-app-password
FIRECRAWL_API_KEY=your-firecrawl-api-key
```

> ⚠️ **Important**:  
> You must use a **Gmail App Password** if you have 2-Step Verification enabled.  
> Learn how to generate one: [Google App Passwords](https://support.google.com/accounts/answer/185833)  
>  
> Get your **Firecrawl API key** from [firecrawl.dev](https://firecrawl.dev) to enable parsing job descriptions from URLs.


### ✉️ Sending Emails

- Emails are sent using **SMTP** via `smtp.gmail.com` on port `587`.
- Each message is read from a `.txt` file where:
  - The **first line** must start with `Subject:`
  - The **remaining lines** form the email body.
- Emails are sent individually with **personalized content** for each recipient.