# AI-Powered HR CV Analysis & Shortlisting System

## Overview

This project is an AI-powered recruitment automation workflow designed to automate CV screening, candidate evaluation, and shortlist generation using LLM-based analysis, workflow orchestration, and API-driven automation.

The system helps HR teams reduce repetitive manual screening effort and improve recruitment efficiency through intelligent AI-assisted candidate assessment.

---

## Key Features

* Automated CV screening workflow
* LLM-powered candidate evaluation
* Skill and experience extraction
* AI-driven candidate scoring
* Automated shortlist recommendations
* Workflow orchestration using n8n and Make.com
* API-driven processing and automation
* HR workflow optimization
* Automated email notification workflows

---

## Technologies Used

* OpenAI API
* n8n
* Make.com
* Python
* REST APIs
* JSON
* Workflow Automation
* AI Workflow Orchestration

---

## Workflow Overview

1. Candidate CV uploaded via email/workflow trigger
2. PDF CV text extracted automatically
3. OpenAI API analyzes candidate profile
4. Skills and experience extracted using LLM-based processing
5. Candidates ranked against job requirements
6. AI-generated shortlist recommendations created
7. Results stored and notification workflows triggered

---

## Business Impact

* Improved HR screening efficiency by approximately 40%
* Reduced manual screening effort by approximately 70%
* Improved recruitment consistency and response speed
* Enabled scalable candidate evaluation workflows

---

## Project Architecture

![Workflow Architecture](architecture-diagram.png)

---

## Workflow Screenshots

### Workflow Overview

![Workflow Overview](screenshots/workflow-overview.png)

### Candidate Evaluation Output

![Candidate Output](screenshots/candidate-ranking-output.png)

---

## Repository Contents

* Sanitized public workflow JSON export
* Workflow screenshots
* Architecture diagram
* Sample workflow outputs
* Project documentation

---

## Demo Video

Loom Walkthrough: [Watch Demo Video](https://www.loom.com/share/9a4614d34cc141e8b48d40c87241cf7e)

---

## GitHub Repository Structure

```text
CV-Screening-AI-Workflow/
│
├── README.md
├── cv-screening-workflow-public.json
├── architecture-diagram.png
├── screenshots/
│   ├── workflow-overview.png
│   └── candidate-ranking-output.png
└── sample-output/
```

---

## Future Improvements

* Multi-role job matching support
* Advanced candidate ranking models
* ATS integration support
* Dashboard and analytics layer
* Multi-language CV support

---

## Author

Jamal Akram
AI Automation & Systems Engineer

LinkedIn:
https://linkedin.com/in/jamal-akram-0a50b47b
