# mukasha09/resume-screen-using-nlp architecture

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

- Interactive diagram: https://gitdiagram.com/mukasha09/resume-screen-using-nlp
- Repository: https://github.com/mukasha09/resume-screen-using-nlp

## Overview

Resume Studio is a local resume-matching and career-coaching app. A user uploads a PDF, DOCX, or TXT; the service extracts its text, compares an embedding against the local job library, and returns the top five matches. The user can then request a CV review or ask follow-up questions, which are sent to Groq only for those actions. The sampled backend and frontend show the main flow; the README documents data requirements and session privacy, but the dataset contents and HTML/CSS implementation were not sampled.

Main entry points: [`app.py`](https://github.com/mukasha09/resume-screen-using-nlp/blob/master/app.py) (FastAPI routes), [`static/app.js`](https://github.com/mukasha09/resume-screen-using-nlp/blob/master/static/app.js) (Resume Studio UI), [`static/index.html`](https://github.com/mukasha09/resume-screen-using-nlp/blob/master/static/index.html) (App page), [`Dataset/job_title_des.csv`](https://github.com/mukasha09/resume-screen-using-nlp/blob/master/Dataset/job_title_des.csv) (Job library)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interface["Browser interface"]
  node_browser["Resume Studio UI<br/>[app.js]"]
  node_page["App page<br/>[index.html]"]
  node_styles["Visual styling<br/>[styles.css]"]
end

subgraph group_matching["Resume matching"]
  node_api["FastAPI routes<br/>[app.py]"]
  node_extract["Resume extraction<br/>[app.py]"]
  node_jobdata[("Job library<br/>[job_title_des.csv]")]
  node_jobvectors[("Job embeddings<br/>[job_embeddings.npy]")]
  node_embed["Resume embedding<br/>[app.py]"]
  node_ranking["Match ranking<br/>[app.py]"]
end

subgraph group_coaching["AI coaching"]
  node_session[("Temporary sessions<br/>[app.py]")]
  node_review["CV review<br/>[app.py]"]
  node_chat["Coach chat<br/>[app.py]"]
end

node_user(("Resume owner"))
node_groq{{"Groq API"}}

node_user -->|"uploads resume"| node_browser
node_browser -->|"requests analysis"| node_api
node_browser -->|"requests review"| node_api
node_browser -->|"sends chat"| node_api
node_api -->|"serves page"| node_page
node_api -->|"serves assets"| node_browser
node_api -->|"extracts text"| node_extract
node_api -->|"loads jobs"| node_jobdata
node_api -->|"loads vectors"| node_jobvectors
node_api -->|"encodes resume"| node_embed
node_api -->|"ranks matches"| node_ranking
node_api -->|"stores analysis"| node_session
node_api -->|"handles review"| node_review
node_review -->|"reads resume context"| node_session
node_review -->|"requests feedback"| node_groq
node_api -->|"handles questions"| node_chat
node_chat -->|"reads resume context"| node_session
node_chat -->|"requests coaching"| node_groq

click node_browser "https://github.com/mukasha09/resume-screen-using-nlp/blob/master/static/app.js"
click node_page "https://github.com/mukasha09/resume-screen-using-nlp/blob/master/static/index.html"
click node_styles "https://github.com/mukasha09/resume-screen-using-nlp/blob/master/static/styles.css"
click node_api "https://github.com/mukasha09/resume-screen-using-nlp/blob/master/app.py"
click node_extract "https://github.com/mukasha09/resume-screen-using-nlp/blob/master/app.py"
click node_jobdata "https://github.com/mukasha09/resume-screen-using-nlp/blob/master/Dataset/job_title_des.csv"
click node_jobvectors "https://github.com/mukasha09/resume-screen-using-nlp/blob/master/job_embeddings.npy"
click node_embed "https://github.com/mukasha09/resume-screen-using-nlp/blob/master/app.py"
click node_ranking "https://github.com/mukasha09/resume-screen-using-nlp/blob/master/app.py"
click node_session "https://github.com/mukasha09/resume-screen-using-nlp/blob/master/app.py"
click node_review "https://github.com/mukasha09/resume-screen-using-nlp/blob/master/app.py"
click node_chat "https://github.com/mukasha09/resume-screen-using-nlp/blob/master/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_browser,node_page,node_styles toneBlue
class node_api,node_extract,node_jobdata,node_jobvectors,node_embed,node_ranking toneAmber
class node_session,node_review,node_chat,node_groq toneMint
class node_user toneIndigo
```

## Components

### Browser interface

- [Resume Studio UI](https://github.com/mukasha09/resume-screen-using-nlp/blob/master/static/app.js): `static/app.js`
- [App page](https://github.com/mukasha09/resume-screen-using-nlp/blob/master/static/index.html): `static/index.html`
- [Visual styling](https://github.com/mukasha09/resume-screen-using-nlp/blob/master/static/styles.css): `static/styles.css`

### Resume matching

- [FastAPI routes](https://github.com/mukasha09/resume-screen-using-nlp/blob/master/app.py): `app.py`
- [Resume extraction](https://github.com/mukasha09/resume-screen-using-nlp/blob/master/app.py): `app.py`
- [Job library](https://github.com/mukasha09/resume-screen-using-nlp/blob/master/Dataset/job_title_des.csv): `Dataset/job_title_des.csv`
- [Job embeddings](https://github.com/mukasha09/resume-screen-using-nlp/blob/master/job_embeddings.npy): `job_embeddings.npy`
- [Resume embedding](https://github.com/mukasha09/resume-screen-using-nlp/blob/master/app.py): `app.py`
- [Match ranking](https://github.com/mukasha09/resume-screen-using-nlp/blob/master/app.py): `app.py`

### AI coaching

- [Temporary sessions](https://github.com/mukasha09/resume-screen-using-nlp/blob/master/app.py): `app.py`
- [CV review](https://github.com/mukasha09/resume-screen-using-nlp/blob/master/app.py): `app.py`
- [Coach chat](https://github.com/mukasha09/resume-screen-using-nlp/blob/master/app.py): `app.py`

### Other components

- **Resume owner**
- **Groq API**

## Connections

- Resume owner → Resume Studio UI: uploads resume (evidence: `static/app.js`)
- Resume Studio UI → FastAPI routes: requests analysis (evidence: `static/app.js`)
- Resume Studio UI → FastAPI routes: requests review (evidence: `static/app.js`)
- Resume Studio UI → FastAPI routes: sends chat (evidence: `static/app.js`)
- FastAPI routes → App page: serves page (evidence: `app.py`)
- FastAPI routes → Resume Studio UI: serves assets (evidence: `app.py`)
- FastAPI routes → Resume extraction: extracts text (evidence: `app.py`)
- FastAPI routes → Job library: loads jobs (evidence: `app.py`)
- FastAPI routes → Job embeddings: loads vectors (evidence: `app.py`)
- FastAPI routes → Resume embedding: encodes resume (evidence: `app.py`)
- FastAPI routes → Match ranking: ranks matches (evidence: `app.py`)
- FastAPI routes → Temporary sessions: stores analysis (evidence: `app.py`)
- FastAPI routes → CV review: handles review (evidence: `app.py`)
- CV review → Temporary sessions: reads resume context (evidence: `app.py`)
- CV review → Groq API: requests feedback (evidence: `app.py`)
- FastAPI routes → Coach chat: handles questions (evidence: `app.py`)
- Coach chat → Temporary sessions: reads resume context (evidence: `app.py`)
- Coach chat → Groq API: requests coaching (evidence: `app.py`)
