# lokeshreddyankireddy-source/ai-resume-reviewer architecture

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

- Interactive diagram: https://gitdiagram.com/lokeshreddyankireddy-source/ai-resume-reviewer
- Repository: https://github.com/lokeshreddyankireddy-source/ai-resume-reviewer

## Overview

AI Resume Reviewer is a Streamlit app for uploading a PDF and receiving AI-generated resume feedback. The principal workflow is upload, extract PDF text, construct a review request from the prompt template, call Gemini, and display the response. The prompt defines the review criteria, including ATS compatibility, skills, experience, education, formatting, and actionable suggestions. The evidence shows these stages in the app and reviewer modules; main.py is a separate Gemini connectivity script, not part of the documented user workflow.

Main entry points: [`ai_reviewer.py`](https://github.com/lokeshreddyankireddy-source/ai-resume-reviewer/blob/main/ai_reviewer.py) (Review Service), [`app.py`](https://github.com/lokeshreddyankireddy-source/ai-resume-reviewer/blob/main/app.py) (Upload Interface), [`pdf_reader.py`](https://github.com/lokeshreddyankireddy-source/ai-resume-reviewer/blob/main/pdf_reader.py) (PDF Extraction), [`prompts.py`](https://github.com/lokeshreddyankireddy-source/ai-resume-reviewer/blob/main/prompts.py) (Review Criteria)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interface["User Interface"]
  node_upload["Upload Interface<br/>[app.py]"]
  node_display["Feedback Display<br/>[app.py]"]
end

subgraph group_processing["Resume Processing"]
  node_pdf["PDF Extraction<br/>[pdf_reader.py]"]
end

subgraph group_ai["AI Review"]
  node_reviewer["Review Service<br/>[ai_reviewer.py]"]
  node_prompt["Review Criteria<br/>[prompts.py]"]
end

node_user(("Resume User"))
node_gemini["Google Gemini"]

node_user -->|"uploads PDF"| node_upload
node_upload -->|"extracts text"| node_pdf
node_upload -->|"submits text"| node_reviewer
node_reviewer -->|"uses criteria"| node_prompt
node_reviewer -->|"requests review"| node_gemini
node_gemini -->|"returns feedback"| node_reviewer
node_reviewer -->|"returns review"| node_display
node_display -->|"shows feedback"| node_user

click node_upload "https://github.com/lokeshreddyankireddy-source/ai-resume-reviewer/blob/main/app.py"
click node_pdf "https://github.com/lokeshreddyankireddy-source/ai-resume-reviewer/blob/main/pdf_reader.py"
click node_reviewer "https://github.com/lokeshreddyankireddy-source/ai-resume-reviewer/blob/main/ai_reviewer.py"
click node_prompt "https://github.com/lokeshreddyankireddy-source/ai-resume-reviewer/blob/main/prompts.py"
click node_display "https://github.com/lokeshreddyankireddy-source/ai-resume-reviewer/blob/main/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_upload,node_display,node_user toneBlue
class node_pdf toneAmber
class node_reviewer,node_prompt toneMint
class node_gemini toneIndigo
```

## Components

### User Interface

- [Upload Interface](https://github.com/lokeshreddyankireddy-source/ai-resume-reviewer/blob/main/app.py): `app.py`
- [Feedback Display](https://github.com/lokeshreddyankireddy-source/ai-resume-reviewer/blob/main/app.py): `app.py`

### Resume Processing

- [PDF Extraction](https://github.com/lokeshreddyankireddy-source/ai-resume-reviewer/blob/main/pdf_reader.py): `pdf_reader.py`

### AI Review

- [Review Service](https://github.com/lokeshreddyankireddy-source/ai-resume-reviewer/blob/main/ai_reviewer.py): `ai_reviewer.py`
- [Review Criteria](https://github.com/lokeshreddyankireddy-source/ai-resume-reviewer/blob/main/prompts.py): `prompts.py`

### Other components

- **Resume User**
- **Google Gemini**

## Connections

- Resume User → Upload Interface: uploads PDF (evidence: `app.py`)
- Upload Interface → PDF Extraction: extracts text (evidence: `app.py`)
- Upload Interface → Review Service: submits text (evidence: `app.py`)
- Review Service → Review Criteria: uses criteria (evidence: `ai_reviewer.py`)
- Review Service → Google Gemini: requests review (evidence: `ai_reviewer.py`)
- Google Gemini → Review Service: returns feedback (evidence: `ai_reviewer.py`)
- Review Service → Feedback Display: returns review (evidence: `app.py`)
- Feedback Display → Resume User: shows feedback (evidence: `app.py`)
