Skip to content

An intelligent resume screening tool that uses machine learning to automatically analyze and rank candidates based on job descriptions. This project extracts key skills and experience from resumes, compares them with role requirements, and generates match scores to help recruiters find the right candidates faster.

Notifications You must be signed in to change notification settings

aozoragh/ai-resume-screener

Repository files navigation

AI Resume Screener

AI Resume Screener

AI-powered resume screener to find the right candidates

🚀 Features

  • 🤖 AI-Powered Analysis - Automatically analyze resumes against job requirements
  • 📊 Smart Ranking - Rank candidates based on skills, experience, and education match
  • 🔍 Detailed Insights - Get AI-generated candidate insights
  • 📱 Responsive Design - Works seamlessly on desktop, tablet, and mobile devices
  • 🎯 Skills Matching - Identify matched and missing skills
  • 📄 Resume Management - Upload and manage multiple resumes

🛠️ Technologies Used

  • Frontend: Next.js, React, TypeScript, Tailwind CSS
  • UI Components: shadcn/ui
  • Animations: Framer Motion
  • AI Integration: OpenAI GPT-4
  • File Processing: PDF.js, mammoth.js

🚀 Getting Started

Prerequisites

  • Node.js 18.0 or later
  • npm or yarn

Installation

  1. Clone the repository:
    git clone https://github.com/aozoragh/ai-resume-screener.git
    cd ai-resume-screener
  2. Install dependencies:
    npm install
    # or
    yarn install
  3. Set up environment variables: Create a .env.local file in the root directory:
    NEXT_PUBLIC_APP_URL=http://localhost:3000
    OPENAI_API_KEY=your_openai_api_key
  4. Start the development server:
    npm run dev
    # or
    yarn dev
  5. Open http://localhost:3000 in your browser.

📖 How to Use

1. Define Job Requirements

  • Enter the job title and description
  • Add required skills
  • Set minimum experience and education level

2. Upload Resumes

  • Drag and drop resumes or use the file browser
  • Supports PDF and DOCX formats

3. Review Results

  • Candidates ranked by match score
  • View detailed candidate profiles
  • See matched and missing skills
  • Read AI-generated analysis

📁 Project Structure

ai-resume-screening/
├── app/                  # Next.js app directory
│   ├── layout.tsx        # Root layout
│   └── page.tsx          # Home page
├── components/           # React components
│   ├── candidate-detail.tsx
│   ├── candidate-results.tsx
│   ├── job-requirements-form.tsx
│   ├── resume-screening-dashboard.tsx
│   ├── resume-uploader.tsx
│   └── ui/               # UI components
├── lib/                  # Utility functions and types
│   ├── resume-analyzer.ts
│   └── types.ts
├── public/               # Static assets
└── ...                   # Config files

🔧 Configuration

Tailwind Configuration

Modify the theme in tailwind.config.js.

AI Model Configuration

Configure model parameters in lib/resume-analyzer.ts.

🙏 Acknowledgements

About

An intelligent resume screening tool that uses machine learning to automatically analyze and rank candidates based on job descriptions. This project extracts key skills and experience from resumes, compares them with role requirements, and generates match scores to help recruiters find the right candidates faster.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published