# junaid7535/job-finder-ai-agent architecture

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

- Interactive diagram: https://gitdiagram.com/junaid7535/job-finder-ai-agent
- Repository: https://github.com/junaid7535/job-finder-ai-agent

## Overview

This repository is a job-search and application assistant. Its main workflow gathers job postings, stores them, compares them with a parsed base resume, tracks application/job status, and can create a job-specific resume PDF. Resume parsing is a separate input path that downloads a resume, extracts text, structures it with an LLM, and saves the result. The README also describes scheduled operation, but workflow files are not in the supplied tree. Edges reflect the README and shown imports/calls; unsampled implementation details are not inferred.

Main entry points: [`supabase_utils.py`](https://github.com/junaid7535/job-finder-ai-agent/blob/main/supabase_utils.py) (Storage access), [`custom_resume_generator.py`](https://github.com/junaid7535/job-finder-ai-agent/blob/main/custom_resume_generator.py) (Resume customizer), [`scraper.py`](https://github.com/junaid7535/job-finder-ai-agent/blob/main/scraper.py) (Job scraper), [`resume_parser.py`](https://github.com/junaid7535/job-finder-ai-agent/blob/main/resume_parser.py) (Resume parser)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_search["Job discovery"]
  node_scraper["Job scraper<br/>[scraper.py]"]
  node_job_manager["Job lifecycle<br/>[job_manager.py]"]
end

subgraph group_resume["Resume processing"]
  node_resume_parser["Resume parser<br/>[resume_parser.py]"]
  node_base_resume["Base resume<br/>[models.py]"]
end

subgraph group_application["Scoring and applications"]
  node_scorer["Job scoring<br/>[score_jobs.py]"]
  node_customizer["Resume customizer"]
  node_pdf_generator["PDF generation<br/>[pdf_generator.py]"]
end

subgraph group_platform["Shared services"]
  node_job_store[("Job and resume data<br/>[init.sql]")]
  node_supabase_utils["Storage access<br/>[supabase_utils.py]"]
  node_llm_client["LLM client<br/>[llm_client.py]"]
  node_config["Configuration<br/>[config.py]"]
  node_user_agents["Request identities<br/>[user_agents.py]"]
end

node_candidate(("Job seeker"))
node_job_sources(("Job sites"))
node_llm_provider(("LLM providers"))

node_candidate -->|"sets search preferences"| node_scraper
node_scraper -->|"fetches postings"| node_job_sources
node_scraper -->|"reads settings"| node_config
node_scraper -->|"uses identities"| node_user_agents
node_scraper -->|"stores jobs"| node_supabase_utils
node_job_manager -->|"manages job records"| node_supabase_utils
node_job_manager -->|"reads thresholds"| node_config
node_job_manager -->|"uses identities"| node_user_agents
node_candidate -->|"provides resume"| node_resume_parser
node_resume_parser -->|"downloads and saves"| node_supabase_utils
node_resume_parser -->|"structures resume"| node_llm_client
node_resume_parser -->|"reads settings"| node_config
node_resume_parser -->|"creates structured data"| node_base_resume
node_scorer -->|"loads and updates jobs"| node_supabase_utils
node_scorer -->|"requests suitability score"| node_llm_client
node_scorer -->|"reads limits"| node_config
node_customizer -->|"loads jobs and saves resumes"| node_supabase_utils
node_customizer -->|"personalizes sections"| node_llm_client
node_customizer -->|"validates resume data"| node_base_resume
node_customizer -->|"renders resume"| node_pdf_generator
node_customizer -->|"reads job limits"| node_config
node_llm_client -->|"sends generation requests"| node_llm_provider
node_supabase_utils -->|"reads and writes"| node_job_store

click node_scraper "https://github.com/junaid7535/job-finder-ai-agent/blob/main/scraper.py"
click node_job_manager "https://github.com/junaid7535/job-finder-ai-agent/blob/main/job_manager.py"
click node_resume_parser "https://github.com/junaid7535/job-finder-ai-agent/blob/main/resume_parser.py"
click node_base_resume "https://github.com/junaid7535/job-finder-ai-agent/blob/main/models.py"
click node_scorer "https://github.com/junaid7535/job-finder-ai-agent/blob/main/score_jobs.py"
click node_customizer "https://github.com/junaid7535/job-finder-ai-agent/blob/main/custom_resume_generator.py"
click node_pdf_generator "https://github.com/junaid7535/job-finder-ai-agent/blob/main/pdf_generator.py"
click node_job_store "https://github.com/junaid7535/job-finder-ai-agent/blob/main/supabase_setup/init.sql"
click node_supabase_utils "https://github.com/junaid7535/job-finder-ai-agent/blob/main/supabase_utils.py"
click node_llm_client "https://github.com/junaid7535/job-finder-ai-agent/blob/main/llm_client.py"
click node_config "https://github.com/junaid7535/job-finder-ai-agent/blob/main/config.py"
click node_user_agents "https://github.com/junaid7535/job-finder-ai-agent/blob/main/user_agents.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_scraper,node_job_manager toneBlue
class node_resume_parser,node_base_resume toneAmber
class node_scorer,node_customizer,node_pdf_generator toneMint
class node_job_store,node_supabase_utils,node_llm_client,node_config,node_user_agents toneRose
class node_candidate,node_job_sources,node_llm_provider toneIndigo
```

## Components

### Job discovery

- [Job scraper](https://github.com/junaid7535/job-finder-ai-agent/blob/main/scraper.py): `scraper.py`
- [Job lifecycle](https://github.com/junaid7535/job-finder-ai-agent/blob/main/job_manager.py): `job_manager.py`

### Resume processing

- [Resume parser](https://github.com/junaid7535/job-finder-ai-agent/blob/main/resume_parser.py): `resume_parser.py`
- [Base resume](https://github.com/junaid7535/job-finder-ai-agent/blob/main/models.py): `models.py`

### Scoring and applications

- [Job scoring](https://github.com/junaid7535/job-finder-ai-agent/blob/main/score_jobs.py): `score_jobs.py`
- [Resume customizer](https://github.com/junaid7535/job-finder-ai-agent/blob/main/custom_resume_generator.py): `custom_resume_generator.py`
- [PDF generation](https://github.com/junaid7535/job-finder-ai-agent/blob/main/pdf_generator.py): `pdf_generator.py`

### Shared services

- [Job and resume data](https://github.com/junaid7535/job-finder-ai-agent/blob/main/supabase_setup/init.sql): `supabase_setup/init.sql`
- [Storage access](https://github.com/junaid7535/job-finder-ai-agent/blob/main/supabase_utils.py): `supabase_utils.py`
- [LLM client](https://github.com/junaid7535/job-finder-ai-agent/blob/main/llm_client.py): `llm_client.py`
- [Configuration](https://github.com/junaid7535/job-finder-ai-agent/blob/main/config.py): `config.py`
- [Request identities](https://github.com/junaid7535/job-finder-ai-agent/blob/main/user_agents.py): `user_agents.py`

### Other components

- **Job seeker**
- **Job sites**
- **LLM providers**

## Connections

- Job seeker → Job scraper: sets search preferences (evidence: `README.md`)
- Job scraper → Job sites: fetches postings (evidence: `README.md`)
- Job scraper → Configuration: reads settings (evidence: `scraper.py`)
- Job scraper → Request identities: uses identities (evidence: `scraper.py`)
- Job scraper → Storage access: stores jobs (evidence: `scraper.py`)
- Job lifecycle → Storage access: manages job records (evidence: `job_manager.py`)
- Job lifecycle → Configuration: reads thresholds (evidence: `job_manager.py`)
- Job lifecycle → Request identities: uses identities (evidence: `job_manager.py`)
- Job seeker → Resume parser: provides resume (evidence: `README.md`)
- Resume parser → Storage access: downloads and saves (evidence: `resume_parser.py`)
- Resume parser → LLM client: structures resume (evidence: `resume_parser.py`)
- Resume parser → Configuration: reads settings (evidence: `resume_parser.py`)
- Resume parser → Base resume: creates structured data (evidence: `resume_parser.py`)
- Job scoring → Storage access: loads and updates jobs (evidence: `score_jobs.py`)
- Job scoring → LLM client: requests suitability score (evidence: `score_jobs.py`)
- Job scoring → Configuration: reads limits (evidence: `score_jobs.py`)
- Resume customizer → Storage access: loads jobs and saves resumes (evidence: `custom_resume_generator.py`)
- Resume customizer → LLM client: personalizes sections (evidence: `custom_resume_generator.py`)
- Resume customizer → Base resume: validates resume data (evidence: `custom_resume_generator.py`)
- Resume customizer → PDF generation: renders resume (evidence: `custom_resume_generator.py`)
- Resume customizer → Configuration: reads job limits (evidence: `custom_resume_generator.py`)
- LLM client → LLM providers: sends generation requests (evidence: `README.md`)
- Storage access → Job and resume data: reads and writes (evidence: `supabase_utils.py`)
