# jomacs/linkedin_auto_jobs_applier_with_ai architecture

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

- Interactive diagram: https://gitdiagram.com/jomacs/linkedin_auto_jobs_applier_with_ai
- Repository: https://github.com/jomacs/linkedin_auto_jobs_applier_with_ai

## Overview

LinkedIn_AIHawk automates a job seeker’s LinkedIn search and Easy Apply workflow: configuration and profile data feed a browser bot that searches listings, filters them, personalizes application answers, and submits applications. The graph includes the documented tailored-resume and tracking capabilities, though their implementation details were not sampled. Edges reflect shown calls, SOURCE INDEX references, or README statements; uncertain internal wiring is omitted.

Main entry points: [`main.py`](https://github.com/jomacs/linkedin_auto_jobs_applier_with_ai/blob/main/main.py) (CLI and setup), [`src/linkedIn_job_manager.py`](https://github.com/jomacs/linkedin_auto_jobs_applier_with_ai/blob/main/src/linkedIn_job_manager.py) (Job search manager), [`src/linkedIn_easy_applier.py`](https://github.com/jomacs/linkedin_auto_jobs_applier_with_ai/blob/main/src/linkedIn_easy_applier.py) (Easy Apply), [`src/gpt.py`](https://github.com/jomacs/linkedin_auto_jobs_applier_with_ai/blob/main/src/gpt.py) (Answer and resume AI)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_setup["Setup and profile"]
  node_config["Search settings<br/>[config.yaml]"]
  node_secrets["Credentials<br/>[secrets.yaml]"]
  node_resume_data["Resume data"]
  node_profile["Application profile"]
end

subgraph group_orchestration["Bot orchestration"]
  node_entry["CLI and setup<br/>[main.py]"]
  node_bot["Bot facade"]
  node_auth["LinkedIn login"]
end

subgraph group_search["Job search and applications"]
  node_manager["Job search manager"]
  node_job["Job record<br/>[job.py]"]
  node_applier["Easy Apply"]
  node_browser_utils["Browser utilities<br/>[utils.py]"]
  node_tracking[("Application tracking")]
end

subgraph group_personalization["AI personalization"]
  node_gpt["Answer and resume AI<br/>[gpt.py]"]
  node_prompts["Prompt templates<br/>[strings.py]"]
  node_tailored_resume["Tailored resumes"]
end

node_jobseeker(("Job seeker"))
node_linkedin{{"LinkedIn"}}
node_openai{{"OpenAI API"}}

node_jobseeker -->|"configures and starts"| node_entry
node_entry -->|"configures and starts"| node_bot
node_entry -->|"creates and configures"| node_auth
node_entry -->|"creates and configures"| node_manager
node_entry -->|"creates and configures"| node_gpt
node_entry -->|"loads profile"| node_profile
node_entry -->|"validates settings"| node_config
node_entry -->|"validates credentials"| node_secrets
node_entry -->|"loads resume"| node_resume_data
node_bot -->|"starts login"| node_auth
node_bot -->|"starts applying"| node_manager
node_auth -->|"authenticates"| node_linkedin
node_manager -->|"creates job records"| node_job
node_manager -->|"dispatches applications"| node_applier
node_manager -->|"searches listings"| node_linkedin
node_applier -->|"submits applications"| node_linkedin
node_applier -->|"requests answers"| node_gpt
node_applier -->|"scrolls forms"| node_browser_utils
node_gpt -->|"uses templates"| node_prompts
node_gpt -->|"generates responses"| node_openai
node_applier -->|"attaches generated resume"| node_tailored_resume
node_manager -->|"tracks applications"| node_tracking

click node_config "https://github.com/jomacs/linkedin_auto_jobs_applier_with_ai/blob/main/data_folder/config.yaml"
click node_secrets "https://github.com/jomacs/linkedin_auto_jobs_applier_with_ai/blob/main/data_folder/secrets.yaml"
click node_resume_data "https://github.com/jomacs/linkedin_auto_jobs_applier_with_ai/blob/main/data_folder/plain_text_resume.yaml"
click node_profile "https://github.com/jomacs/linkedin_auto_jobs_applier_with_ai/blob/main/src/job_application_profile.py"
click node_entry "https://github.com/jomacs/linkedin_auto_jobs_applier_with_ai/blob/main/main.py"
click node_bot "https://github.com/jomacs/linkedin_auto_jobs_applier_with_ai/blob/main/src/linkedIn_bot_facade.py"
click node_auth "https://github.com/jomacs/linkedin_auto_jobs_applier_with_ai/blob/main/src/linkedIn_authenticator.py"
click node_manager "https://github.com/jomacs/linkedin_auto_jobs_applier_with_ai/blob/main/src/linkedIn_job_manager.py"
click node_job "https://github.com/jomacs/linkedin_auto_jobs_applier_with_ai/blob/main/src/job.py"
click node_applier "https://github.com/jomacs/linkedin_auto_jobs_applier_with_ai/blob/main/src/linkedIn_easy_applier.py"
click node_gpt "https://github.com/jomacs/linkedin_auto_jobs_applier_with_ai/blob/main/src/gpt.py"
click node_prompts "https://github.com/jomacs/linkedin_auto_jobs_applier_with_ai/blob/main/src/strings.py"
click node_browser_utils "https://github.com/jomacs/linkedin_auto_jobs_applier_with_ai/blob/main/src/utils.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_config,node_secrets,node_resume_data,node_profile toneBlue
class node_entry,node_bot,node_auth toneAmber
class node_manager,node_job,node_applier,node_browser_utils,node_tracking,node_openai toneMint
class node_gpt,node_prompts,node_tailored_resume toneRose
class node_jobseeker,node_linkedin toneIndigo
```

## Components

### Setup and profile

- [Search settings](https://github.com/jomacs/linkedin_auto_jobs_applier_with_ai/blob/main/data_folder/config.yaml): `data_folder/config.yaml`
- [Credentials](https://github.com/jomacs/linkedin_auto_jobs_applier_with_ai/blob/main/data_folder/secrets.yaml): `data_folder/secrets.yaml`
- [Resume data](https://github.com/jomacs/linkedin_auto_jobs_applier_with_ai/blob/main/data_folder/plain_text_resume.yaml): `data_folder/plain_text_resume.yaml`
- [Application profile](https://github.com/jomacs/linkedin_auto_jobs_applier_with_ai/blob/main/src/job_application_profile.py): `src/job_application_profile.py`

### Bot orchestration

- [CLI and setup](https://github.com/jomacs/linkedin_auto_jobs_applier_with_ai/blob/main/main.py): `main.py`
- [Bot facade](https://github.com/jomacs/linkedin_auto_jobs_applier_with_ai/blob/main/src/linkedIn_bot_facade.py): `src/linkedIn_bot_facade.py`
- [LinkedIn login](https://github.com/jomacs/linkedin_auto_jobs_applier_with_ai/blob/main/src/linkedIn_authenticator.py): `src/linkedIn_authenticator.py`

### Job search and applications

- [Job search manager](https://github.com/jomacs/linkedin_auto_jobs_applier_with_ai/blob/main/src/linkedIn_job_manager.py): `src/linkedIn_job_manager.py`
- [Job record](https://github.com/jomacs/linkedin_auto_jobs_applier_with_ai/blob/main/src/job.py): `src/job.py`
- [Easy Apply](https://github.com/jomacs/linkedin_auto_jobs_applier_with_ai/blob/main/src/linkedIn_easy_applier.py): `src/linkedIn_easy_applier.py`
- [Browser utilities](https://github.com/jomacs/linkedin_auto_jobs_applier_with_ai/blob/main/src/utils.py): `src/utils.py`
- **Application tracking**

### AI personalization

- [Answer and resume AI](https://github.com/jomacs/linkedin_auto_jobs_applier_with_ai/blob/main/src/gpt.py): `src/gpt.py`
- [Prompt templates](https://github.com/jomacs/linkedin_auto_jobs_applier_with_ai/blob/main/src/strings.py): `src/strings.py`
- **Tailored resumes**

### Other components

- **Job seeker**
- **LinkedIn**
- **OpenAI API**

## Connections

- Job seeker → CLI and setup: configures and starts (evidence: `README.md`)
- CLI and setup → Bot facade: configures and starts (evidence: `main.py`)
- CLI and setup → LinkedIn login: creates and configures (evidence: `main.py`)
- CLI and setup → Job search manager: creates and configures (evidence: `main.py`)
- CLI and setup → Answer and resume AI: creates and configures (evidence: `main.py`)
- CLI and setup → Application profile: loads profile (evidence: `README.md`)
- CLI and setup → Search settings: validates settings (evidence: `README.md`)
- CLI and setup → Credentials: validates credentials (evidence: `README.md`)
- CLI and setup → Resume data: loads resume (evidence: `README.md`)
- Bot facade → LinkedIn login: starts login (evidence: `src/linkedIn_bot_facade.py`)
- Bot facade → Job search manager: starts applying (evidence: `src/linkedIn_bot_facade.py`)
- LinkedIn login → LinkedIn: authenticates (evidence: `src/linkedIn_authenticator.py`)
- Job search manager → Job record: creates job records (evidence: `src/linkedIn_job_manager.py`)
- Job search manager → Easy Apply: dispatches applications (evidence: `src/linkedIn_job_manager.py`)
- Job search manager → LinkedIn: searches listings (evidence: `README.md`)
- Easy Apply → LinkedIn: submits applications (evidence: `src/linkedIn_easy_applier.py`)
- Easy Apply → Answer and resume AI: requests answers (evidence: `src/linkedIn_easy_applier.py`)
- Easy Apply → Browser utilities: scrolls forms (evidence: `src/linkedIn_easy_applier.py`)
- Answer and resume AI → Prompt templates: uses templates (evidence: `src/gpt.py`)
- Answer and resume AI → OpenAI API: generates responses (evidence: `README.md`)
- Easy Apply → Tailored resumes: attaches generated resume (evidence: `README.md`)
- Job search manager → Application tracking: tracks applications (evidence: `README.md`)
