ATS Resume Score Agent

A simple and fast Applicant Tracking System (ATS) resume scorer using Google Gemini AI. This tool evaluates resumes and provides structured scoring with name extraction, email detection, and some feedback.

Features

• 📄 Supports PDF and Word document formats (.pdf, .docx, .doc)
• 🤖 AI-powered evaluation using Google Gemini
• 📊 Structured output with scoring (0-1 scale)
• 📈 Excel export with detailed results
• 🚀 Fast batch processing
• 📝 Comprehensive logging

Project Structure

ats-resume-score-agent/
├── resumes/                 # Place resume files here
├── output/                  # Excel output files
├── .env                     # API keys
├── main.py                  # Main application entry point
├── job_description.txt      # Job requirements file
...

Setup Instructions

1. Install Dependencies

pip install -r requirements.txt

2. Configure API Key

1. Get your Google AI API key from Google AI Studio.
2. Rename .env.sample to .env file and replace your_google_api_key_here with your actual API key:

3. Add Resume Files

Place your resume files (PDF, DOCX, DOC) in the ./resumes/ folder.

4. Run the Application

python main.py

Output Format

The tool generates an Excel file in the ./output/ folder with the following:

• Name: Extracted candidate name
• Email: Extracted email address
• Score: ATS score (0.0 to 1.0)
• Notes: AI-generated evaluation notes
• Processing Date: When the resume was processed

License

This project is licensed under the MIT License. See the MIT License file.