Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

12 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

ATS Resume Scanner (AWS + GCP + Gemini AI)

AI-powered ATS Resume Scanner built using Streamlit + Python + Google Gemini + AWS EC2.

Users can:

  • Upload Resume PDF
  • Paste Job Description (JD)
  • Get ATS Match Score
  • Resume Review
  • Keyword Analysis

Architecture

User
 ↓
Streamlit UI
 ↓
Resume PDF Processing
(pdf2image)
 ↓
Google Gemini AI
 ↓
ATS Review + Match Score

Prerequisites

  • AWS Account
  • Ubuntu EC2 Instance
  • Python 3.7+
  • Google Gemini API Key

Part 1 — Launch AWS EC2 Instance

Create:

  • Ubuntu Server 20.04 LTS
  • Open Port:
    • 22 (SSH)
    • 8501 (Streamlit)

Connect:

ssh -i your-key.pem ubuntu@YOUR_PUBLIC_IP

Switch root:

sudo -i

Part 2 — Install Dependencies

Update:

apt update && apt upgrade -y

Install Python:

apt install python3 python3-pip python3-venv -y

Verify:

python3 --version
pip3 --version

Install Git:

apt install git -y

Verify:

git --version

Install Poppler:

apt install poppler-utils -y

Verify:

pdftoppm -v

Part 3 — Clone Repository

git clone https://github.com/vikash93825/ATS-Multi-Cloud-AI-Project.git

cd ATS-Multi-Cloud-AI-Project

Part 4 — Create Virtual Environment

Create:

python3 -m venv venv

Activate:

source venv/bin/activate

Expected:

(venv)

Part 5 — Install Packages

Upgrade pip:

pip install --upgrade pip

Install dependencies:

pip install -r requirements.txt

Install Gemini SDK:

pip install google-generativeai

Part 6 — Configure Gemini API

Generate API Key

Google AI Studio

  1. Open Google AI Studio
  2. Create Project
  3. API Keys
  4. Create API Key

Copy key.


Part 7 — Configure Streamlit Secrets

Create folder:

mkdir -p .streamlit

Open:

vi .streamlit/secrets.toml

Add:

GOOGLE_API_KEY="YOUR_API_KEY"

Save:

ESC
:wq

Part 8 — Run Application

Start:

streamlit run app.py \
--server.port 8501 \
--server.enableCORS false

Output:

Local URL:
http://localhost:8501

Network URL:
http://PUBLIC_IP:8501

Open:

http://YOUR_PUBLIC_IP:8501

Project Structure

ATS-Multi-Cloud-AI-Project/
│
├── app.py
├── requirements.txt
├── README.md
├── .streamlit/
│    └── secrets.toml
│
├── uploads/
├── assets/
├── utils/
└── venv/

Features

✅ Resume Upload
✅ ATS Analysis
✅ Gemini Integration
✅ Match Score
✅ Resume Review
✅ Keywords Analysis
✅ AWS Deployment


Troubleshooting

Port issue

sudo ufw allow 8501
sudo ufw reload

Missing poppler

sudo apt install poppler-utils

Verify Gemini Key

cat .streamlit/secrets.toml

Expected:

GOOGLE_API_KEY="YOUR_KEY"

Author

Vikash Kumar

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages