# anshika66/-resume-matcher-nlp architecture

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

- Interactive diagram: https://gitdiagram.com/anshika66/-resume-matcher-nlp
- Repository: https://github.com/anshika66/-resume-matcher-nlp

## Overview

Resume Matcher is a Flask web app for comparing uploaded resumes with a job description and showing the top matches with similarity scores. The main workflow accepts the form, saves and extracts resume text, computes TF-IDF vectors and cosine similarity, ranks candidates, and renders the results. The README also documents PDF, DOCX, and TXT support. The HTML file is listed in the tree and referenced by the route, but its contents were not sampled; no separate storage service is evidenced.

Main entry points: [`main.py`](https://github.com/anshika66/-resume-matcher-nlp/blob/main/main.py) (Form submission), [`matchresume.html`](https://github.com/anshika66/-resume-matcher-nlp/blob/main/matchresume.html) (Match results UI)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web interaction"]
  node_flask["Flask routes<br/>[main.py]"]
  node_submission["Form submission<br/>[main.py]"]
  node_resume_files["Resume uploads<br/>[main.py]"]
end

subgraph group_matching["Resume matching"]
  node_text_extract["Text extraction<br/>[main.py]"]
  node_tfidf["TF-IDF vectors<br/>[main.py]"]
  node_similarity["Cosine similarity<br/>[main.py]"]
end

subgraph group_results["Results"]
  node_ranking["Top-three ranking<br/>[main.py]"]
  node_template["Match results UI<br/>[matchresume.html]"]
end

node_user(("Job seeker"))

node_user -->|"opens app"| node_flask
node_flask -->|"renders home"| node_template
node_user -->|"submits form"| node_submission
node_submission -->|"saves uploads"| node_resume_files
node_submission -->|"extracts text"| node_text_extract
node_submission -->|"vectorizes texts"| node_tfidf
node_submission -->|"computes scores"| node_similarity
node_submission -->|"selects matches"| node_ranking
node_submission -->|"renders results"| node_template

click node_flask "https://github.com/anshika66/-resume-matcher-nlp/blob/main/main.py"
click node_submission "https://github.com/anshika66/-resume-matcher-nlp/blob/main/main.py"
click node_resume_files "https://github.com/anshika66/-resume-matcher-nlp/blob/main/main.py"
click node_text_extract "https://github.com/anshika66/-resume-matcher-nlp/blob/main/main.py"
click node_tfidf "https://github.com/anshika66/-resume-matcher-nlp/blob/main/main.py"
click node_similarity "https://github.com/anshika66/-resume-matcher-nlp/blob/main/main.py"
click node_ranking "https://github.com/anshika66/-resume-matcher-nlp/blob/main/main.py"
click node_template "https://github.com/anshika66/-resume-matcher-nlp/blob/main/matchresume.html"

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_flask,node_submission,node_resume_files toneBlue
class node_text_extract,node_tfidf,node_similarity toneAmber
class node_ranking,node_template toneMint
class node_user toneIndigo
```

## Components

### Web interaction

- [Flask routes](https://github.com/anshika66/-resume-matcher-nlp/blob/main/main.py): `main.py`
- [Form submission](https://github.com/anshika66/-resume-matcher-nlp/blob/main/main.py): `main.py`
- [Resume uploads](https://github.com/anshika66/-resume-matcher-nlp/blob/main/main.py): `main.py`

### Resume matching

- [Text extraction](https://github.com/anshika66/-resume-matcher-nlp/blob/main/main.py): `main.py`
- [TF-IDF vectors](https://github.com/anshika66/-resume-matcher-nlp/blob/main/main.py): `main.py`
- [Cosine similarity](https://github.com/anshika66/-resume-matcher-nlp/blob/main/main.py): `main.py`

### Results

- [Top-three ranking](https://github.com/anshika66/-resume-matcher-nlp/blob/main/main.py): `main.py`
- [Match results UI](https://github.com/anshika66/-resume-matcher-nlp/blob/main/matchresume.html): `matchresume.html`

### Other components

- **Job seeker**

## Connections

- Job seeker → Flask routes: opens app (evidence: `README.md`)
- Flask routes → Match results UI: renders home (evidence: `main.py`)
- Job seeker → Form submission: submits form (evidence: `README.md`)
- Form submission → Resume uploads: saves uploads (evidence: `main.py`)
- Form submission → Text extraction: extracts text (evidence: `main.py`)
- Form submission → TF-IDF vectors: vectorizes texts (evidence: `main.py`)
- Form submission → Cosine similarity: computes scores (evidence: `main.py`)
- Form submission → Top-three ranking: selects matches (evidence: `main.py`)
- Form submission → Match results UI: renders results (evidence: `main.py`)
