# pneha244/ai-resume-screening-system architecture

> Architecture diagram of the GitHub repository pneha244/ai-resume-screening-system, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/pneha244/ai-resume-screening-system
- Repository: https://github.com/pneha244/ai-resume-screening-system

## Overview

Recruiters upload PDF or DOCX resumes and enter a job description in the Streamlit app. The app extracts resume text, compares it with the job description, derives skills and candidate details, then categorizes and shortlists candidates before presenting ranked results. The results interface supports status filtering, optional resume previews, dashboard counts, and CSV export. The README documents these capabilities; the main screening calls and result-handling steps are also visible in app.py.

Main entry points: [`ai_resume_screening_system/app.py`](https://github.com/pneha244/ai-resume-screening-system/blob/main/ai_resume_screening_system/app.py) (Screening App), [`ai_resume_screening_system/resume_parser.py`](https://github.com/pneha244/ai-resume-screening-system/blob/main/ai_resume_screening_system/resume_parser.py) (Resume Parser), [`ai_resume_screening_system/skills_extractor.py`](https://github.com/pneha244/ai-resume-screening-system/blob/main/ai_resume_screening_system/skills_extractor.py) (Skill Analysis), [`ai_resume_screening_system/matcher.py`](https://github.com/pneha244/ai-resume-screening-system/blob/main/ai_resume_screening_system/matcher.py) (Resume Matching)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_intake["Screening Intake"]
  node_screening_app["Screening App<br/>[app.py]"]
end

subgraph group_analysis["Resume Analysis"]
  node_resume_parser["Resume Parser<br/>[resume_parser.py]"]
  node_skill_analysis["Skill Analysis"]
  node_resume_matching["Resume Matching<br/>[matcher.py]"]
  node_candidate_details["Candidate Details<br/>[candidate_info.py]"]
end

subgraph group_decisions["Candidate Decisions"]
  node_score_category["Score Categories<br/>[score_category.py]"]
  node_shortlist_decision["Shortlist Decision<br/>[app.py]"]
  node_candidate_records["Candidate Records<br/>[app.py]"]
  node_ranking["Candidate Ranking<br/>[app.py]"]
end

subgraph group_results["Results Interface"]
  node_dashboard["Screening Dashboard<br/>[app.py]"]
  node_candidate_filter["Candidate Filtering<br/>[app.py]"]
  node_resume_preview["Resume Preview<br/>[app.py]"]
  node_csv_report["CSV Report<br/>[app.py]"]
end

node_recruiter(("Recruiter"))

node_recruiter -->|"submits screening"| node_screening_app
node_screening_app -->|"extracts text"| node_resume_parser
node_screening_app -->|"extracts skills"| node_skill_analysis
node_screening_app -->|"calculates match"| node_resume_matching
node_screening_app -->|"extracts details"| node_candidate_details
node_screening_app -->|"categorizes score"| node_score_category
node_screening_app -->|"applies threshold"| node_shortlist_decision
node_screening_app -->|"assembles results"| node_candidate_records
node_screening_app -->|"sorts candidates"| node_ranking
node_screening_app -->|"displays counts"| node_dashboard
node_screening_app -->|"filters results"| node_candidate_filter
node_screening_app -->|"shows preview"| node_resume_preview
node_screening_app -->|"exports results"| node_csv_report

click node_screening_app "https://github.com/pneha244/ai-resume-screening-system/blob/main/ai_resume_screening_system/app.py"
click node_resume_parser "https://github.com/pneha244/ai-resume-screening-system/blob/main/ai_resume_screening_system/resume_parser.py"
click node_skill_analysis "https://github.com/pneha244/ai-resume-screening-system/blob/main/ai_resume_screening_system/skills_extractor.py"
click node_resume_matching "https://github.com/pneha244/ai-resume-screening-system/blob/main/ai_resume_screening_system/matcher.py"
click node_candidate_details "https://github.com/pneha244/ai-resume-screening-system/blob/main/ai_resume_screening_system/candidate_info.py"
click node_score_category "https://github.com/pneha244/ai-resume-screening-system/blob/main/ai_resume_screening_system/score_category.py"
click node_shortlist_decision "https://github.com/pneha244/ai-resume-screening-system/blob/main/ai_resume_screening_system/app.py"
click node_candidate_records "https://github.com/pneha244/ai-resume-screening-system/blob/main/ai_resume_screening_system/app.py"
click node_ranking "https://github.com/pneha244/ai-resume-screening-system/blob/main/ai_resume_screening_system/app.py"
click node_dashboard "https://github.com/pneha244/ai-resume-screening-system/blob/main/ai_resume_screening_system/app.py"
click node_candidate_filter "https://github.com/pneha244/ai-resume-screening-system/blob/main/ai_resume_screening_system/app.py"
click node_resume_preview "https://github.com/pneha244/ai-resume-screening-system/blob/main/ai_resume_screening_system/app.py"
click node_csv_report "https://github.com/pneha244/ai-resume-screening-system/blob/main/ai_resume_screening_system/app.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_screening_app toneBlue
class node_resume_parser,node_skill_analysis,node_resume_matching,node_candidate_details toneAmber
class node_score_category,node_shortlist_decision,node_candidate_records,node_ranking toneMint
class node_dashboard,node_candidate_filter,node_resume_preview,node_csv_report toneRose
class node_recruiter toneIndigo
```

## Components

### Screening Intake

- [Screening App](https://github.com/pneha244/ai-resume-screening-system/blob/main/ai_resume_screening_system/app.py): `ai_resume_screening_system/app.py`

### Resume Analysis

- [Resume Parser](https://github.com/pneha244/ai-resume-screening-system/blob/main/ai_resume_screening_system/resume_parser.py): `ai_resume_screening_system/resume_parser.py`
- [Skill Analysis](https://github.com/pneha244/ai-resume-screening-system/blob/main/ai_resume_screening_system/skills_extractor.py): `ai_resume_screening_system/skills_extractor.py`
- [Resume Matching](https://github.com/pneha244/ai-resume-screening-system/blob/main/ai_resume_screening_system/matcher.py): `ai_resume_screening_system/matcher.py`
- [Candidate Details](https://github.com/pneha244/ai-resume-screening-system/blob/main/ai_resume_screening_system/candidate_info.py): `ai_resume_screening_system/candidate_info.py`

### Candidate Decisions

- [Score Categories](https://github.com/pneha244/ai-resume-screening-system/blob/main/ai_resume_screening_system/score_category.py): `ai_resume_screening_system/score_category.py`
- [Shortlist Decision](https://github.com/pneha244/ai-resume-screening-system/blob/main/ai_resume_screening_system/app.py): `ai_resume_screening_system/app.py`
- [Candidate Records](https://github.com/pneha244/ai-resume-screening-system/blob/main/ai_resume_screening_system/app.py): `ai_resume_screening_system/app.py`
- [Candidate Ranking](https://github.com/pneha244/ai-resume-screening-system/blob/main/ai_resume_screening_system/app.py): `ai_resume_screening_system/app.py`

### Results Interface

- [Screening Dashboard](https://github.com/pneha244/ai-resume-screening-system/blob/main/ai_resume_screening_system/app.py): `ai_resume_screening_system/app.py`
- [Candidate Filtering](https://github.com/pneha244/ai-resume-screening-system/blob/main/ai_resume_screening_system/app.py): `ai_resume_screening_system/app.py`
- [Resume Preview](https://github.com/pneha244/ai-resume-screening-system/blob/main/ai_resume_screening_system/app.py): `ai_resume_screening_system/app.py`
- [CSV Report](https://github.com/pneha244/ai-resume-screening-system/blob/main/ai_resume_screening_system/app.py): `ai_resume_screening_system/app.py`

### Other components

- **Recruiter**

## Connections

- Recruiter → Screening App: submits screening (evidence: `README.md`)
- Screening App → Resume Parser: extracts text (evidence: `ai_resume_screening_system/app.py`)
- Screening App → Skill Analysis: extracts skills (evidence: `ai_resume_screening_system/app.py`)
- Screening App → Resume Matching: calculates match (evidence: `ai_resume_screening_system/app.py`)
- Screening App → Candidate Details: extracts details (evidence: `ai_resume_screening_system/app.py`)
- Screening App → Score Categories: categorizes score (evidence: `ai_resume_screening_system/app.py`)
- Screening App → Shortlist Decision: applies threshold (evidence: `ai_resume_screening_system/app.py`)
- Screening App → Candidate Records: assembles results (evidence: `ai_resume_screening_system/app.py`)
- Screening App → Candidate Ranking: sorts candidates (evidence: `ai_resume_screening_system/app.py`)
- Screening App → Screening Dashboard: displays counts (evidence: `ai_resume_screening_system/app.py`)
- Screening App → Candidate Filtering: filters results (evidence: `ai_resume_screening_system/app.py`)
- Screening App → Resume Preview: shows preview (evidence: `ai_resume_screening_system/app.py`)
- Screening App → CSV Report: exports results (evidence: `ai_resume_screening_system/app.py`)
