SmartRecruit AI 🚀

SmartRecruit AI is an intelligent Applicant Tracking System (ATS) designed to streamline the recruitment process. It leverages the power of OpenAI (GPT-4o) and Vector Embeddings to automatically parse resumes, match them against job descriptions, and rank candidates based on relevance.

---

🔥 Features

• 📄 Automated Resume Parsing:

  • Extracts key details (Name, Email, Phone, Skills) from PDF resumes automatically.
  • Supports bulk uploading of multiple CVs at once.

• 🧠 AI-Powered Matching:

  • Uses Semantic Search (Cosine Similarity) to compare resumes with job descriptions.
  • Scores candidates from 0% to 100% based on relevance.

• 📊 Intelligent Ranking & Status:

  • Categorizes candidates as Perfect Match, Strong Candidate, Potential, or Mismatch.
  • Displays a visual match score progress bar.

• 🔎 Smart Dashboard:

  • View all processed candidates in a sleek, glassmorphism-style dashboard.
  • Quickly filter and view original PDF resumes directly in the browser.

---

🛠️ Tech Stack

Backend

• Python (3.10+)
• FastAPI - High-performance web framework.
• PostgreSQL - Relational database for storage.
• SQLAlchemy - ORM for database interaction.
• OpenAI API - GPT-4o & text-embedding-3-small for AI logic.
• scikit-learn - For cosine similarity calculations.
• PDFPlumber - For text extraction from PDFs.

Frontend

• React.js (Vite) - Fast and modern frontend library.
• Tailwind CSS (v4) - For beautiful, responsive styling.
• Axios - For API communication.

---

🚀 Getting Started

Follow these instructions to set up the project locally.

Prerequisites

• Python 3.10 or higher
• Node.js (v18 or higher)
• PostgreSQL installed and running

1️⃣ Clone the Repository

git clone https://github.com/Randidu/smart-recruit-ai.git
cd smart-recruit-ai

2️⃣ Backend Setup

1. Navigate to the backend folder:

   cd backend

2. Create and activate a virtual environment (optional but recommended):

   python -m venv venv
   source venv/bin/activate  # On Windows: venv\Scripts\activate

3. Install dependencies:

   pip install -r requirements.txt

4. Configure Environment Variables:
   • Create a .env file in the backend directory.
   • Add your OpenAI API Key and Database URL:

     OPENAI_API_KEY=your_openai_api_key_here
     DATABASE_URL=postgresql://user:password@localhost/smartrecruit

5. Run the server:

   python -m uvicorn main:app --reload

3️⃣ Frontend Setup

1. Navigate to the frontend folder (open a new terminal):

   cd frontend

2. Install dependencies:

   npm install

3. Run the development server:

   npm run dev

---

📸 Screenshots

(Add screenshots of your Upload Section and Results Dashboard here)

---

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

---

📄 License

This project is licensed under the MIT License.