Skip to content
ATS Screener

Setup Guide

ATS Screener can be self-hosted for free. You’ll need at least one LLM API key.

Prerequisites

Section titled “Prerequisites”
  • Node.js 18+ (20 recommended)
  • pnpm 8+ (package manager)
  • A free API key from Google AI Studio (required for Gemma 3 27B)

Installation

Section titled “Installation”
Terminal window
# clone the repo
git clone https://github.com/sunnypatell/ats-screener.git
cd ats-screener


# install dependencies
pnpm install


# copy environment template
cp .env.example .env

Get API Keys (Free)

Section titled “Get API Keys (Free)”

Google Gemini (Primary)

Section titled “Google Gemini (Primary)”
  1. Go to Google AI Studio
  2. Click “Create API Key”
  3. Add to .env: GEMINI_API_KEY=your_key_here
Section titled “Groq (Recommended Fallback)”
  1. Go to Groq Console
  2. Create a new API key
  3. Add to .env: GROQ_API_KEY=your_key_here

Run Locally

Section titled “Run Locally”
Terminal window
# development server with hot reload
pnpm dev


# the app will be available at http://localhost:5173

Build for Production

Section titled “Build for Production”
Terminal window
# create production build
pnpm build


# preview the production build locally
pnpm preview

Verify It Works

Section titled “Verify It Works”
  1. Open http://localhost:5173
  2. Navigate to /scanner
  3. Upload a PDF or DOCX resume
  4. You should see scores from all 6 platforms

If you see a 503 error, check that your API keys are correctly set in .env.