Skip to content

emmanuelJet/ats-analyzer

Repository files navigation

ATS Resume Analyzer 🤖

An intelligent, AI-powered ATS (Applicant Tracking System) Resume Analyzer built with Next.js and the Gemini API. It compares your resume against a target job description and provides actionable insights.

This is a project built by Emmanuel Joseph (JET) during the "Build a Resume Analyzer with AI" session at the GDGoC BOUESTI 2026 "Build with AI" event. Click here for the session slide.

🚀 Overview

Upload your resume (PDF) alongside a target job description. Our strict AI Recruiter engine analyzes your profile contextually to deliver:

  • ATS Match Score: A clear percentage match score indicating your alignment with the role.
  • Keyword Gap Analysis: Precise identification of missing but highly expected keywords.
  • Actionable Recruiter Feedback: Direct and critical formatting, structural, and content improvement tips to beat system filters.

💻 Tech Stack

  • Framework: Next.js (App Router)
  • Library: React 19
  • Styling: Tailwind CSS v4
  • Intelligence: Google Gemini API
  • Language: TypeScript
  • Design Philosophy: Clean, glassmorphism-inspired UI with smooth micro-animations.

🛠️ Getting Started

Prerequisites

  • Node.js (v20 or higher)
  • npm, yarn, or pnpm

Installation

  1. Clone the repository and navigate to the project directory:

    git clone https://github.com/emmanuelJet/ats-analyzer
    cd ats-analyzer
  2. Install dependencies:

    npm install
  3. Set up environment variables. Create a .env or .env.local file in the root directory:

    GEMINI_API_KEY=your_google_gemini_api_key_here
  4. Start the development server:

    npm run dev
  5. Open http://localhost:3000 in your browser to see the application.

About

An intelligent, AI-powered ATS (Applicant Tracking System) Resume Analyzer built with Next.js and the Gemini API.

Topics

Resources

Stars

Watchers

Forks

Contributors