# 11844/auto_jobs_applier_aihawk architecture

> Architecture diagram of the GitHub repository 11844/auto_jobs_applier_aihawk, 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/11844/auto_jobs_applier_aihawk
- Repository: https://github.com/11844/auto_jobs_applier_aihawk

## Overview

AIHawk automates LinkedIn job search and applications: a user supplies search settings, credentials, a resume, and a YAML profile; the program validates inputs, logs in, gathers and filters jobs, then applies with profile-informed answers and document uploads. The README also describes tailored resume generation, bulk application management, and tracking. Source excerpts show the facade’s dispatch and application-form behavior, but omit parts of startup and job processing, so those relationships are limited to documented or indexed evidence.

Main entry points: [`main.py`](https://github.com/11844/auto_jobs_applier_aihawk/blob/main/main.py) (CLI startup), [`src/aihawk_easy_applier.py`](https://github.com/11844/auto_jobs_applier_aihawk/blob/main/src/aihawk_easy_applier.py) (Easy Apply automation), [`src/llm/llm_manager.py`](https://github.com/11844/auto_jobs_applier_aihawk/blob/main/src/llm/llm_manager.py) (LLM manager), [`src/aihawk_job_manager.py`](https://github.com/11844/auto_jobs_applier_aihawk/blob/main/src/aihawk_job_manager.py) (Job search manager)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_startup["Setup and orchestration"]
  node_entry["CLI startup<br/>[main.py]"]
  node_settings["Search settings<br/>[config.yaml]"]
  node_secrets["API credentials<br/>[secrets.yaml]"]
  node_facade["Bot facade"]
  node_browser["Chrome browser<br/>[utils.py]"]
  node_auth["Login and session"]
end

subgraph group_search["Job discovery"]
  node_manager["Job search manager"]
  node_job["Job record<br/>[job.py]"]
end

subgraph group_application["Application workflow"]
  node_applier["Easy Apply automation"]
  node_resume["Tailored resume"]
  node_tracking["Application tracking"]
end

subgraph group_personalization["Profile and AI"]
  node_profile["Application profile"]
  node_llm["LLM manager<br/>[llm_manager.py]"]
  node_prompts["Prompt templates<br/>[strings.py]"]
end

node_user(("Job seeker"))
node_linkedin["LinkedIn"]
node_llm_service["LLM provider"]

node_user -->|"starts"| node_entry
node_entry -->|"loads"| node_settings
node_entry -->|"loads"| node_secrets
node_entry -->|"initializes"| node_profile
node_entry -->|"configures"| node_facade
node_entry -->|"initializes"| node_llm
node_facade -->|"starts login"| node_auth
node_facade -->|"starts search or apply"| node_applier
node_auth -.->|"uses"| node_browser
node_auth -->|"authenticates with"| node_linkedin
node_manager -->|"searches jobs"| node_linkedin
node_manager -.->|"creates records"| node_job
node_manager -->|"delegates applications"| node_applier
node_applier -->|"submits applications"| node_linkedin
node_applier -.->|"requests answers"| node_llm
node_llm -->|"uses templates"| node_prompts
node_llm -.->|"invokes model"| node_llm_service
node_applier -->|"uploads documents"| node_resume
node_applier -->|"records answers"| node_tracking
node_profile -.->|"provides response context"| node_llm

click node_entry "https://github.com/11844/auto_jobs_applier_aihawk/blob/main/main.py"
click node_settings "https://github.com/11844/auto_jobs_applier_aihawk/blob/main/data_folder/config.yaml"
click node_secrets "https://github.com/11844/auto_jobs_applier_aihawk/blob/main/data_folder/secrets.yaml"
click node_facade "https://github.com/11844/auto_jobs_applier_aihawk/blob/main/src/aihawk_bot_facade.py"
click node_browser "https://github.com/11844/auto_jobs_applier_aihawk/blob/main/src/utils.py"
click node_auth "https://github.com/11844/auto_jobs_applier_aihawk/blob/main/src/aihawk_authenticator.py"
click node_manager "https://github.com/11844/auto_jobs_applier_aihawk/blob/main/src/aihawk_job_manager.py"
click node_job "https://github.com/11844/auto_jobs_applier_aihawk/blob/main/src/job.py"
click node_profile "https://github.com/11844/auto_jobs_applier_aihawk/blob/main/src/job_application_profile.py"
click node_applier "https://github.com/11844/auto_jobs_applier_aihawk/blob/main/src/aihawk_easy_applier.py"
click node_llm "https://github.com/11844/auto_jobs_applier_aihawk/blob/main/src/llm/llm_manager.py"
click node_prompts "https://github.com/11844/auto_jobs_applier_aihawk/blob/main/src/strings.py"
click node_resume "https://github.com/11844/auto_jobs_applier_aihawk/blob/main/src/aihawk_easy_applier.py"
click node_tracking "https://github.com/11844/auto_jobs_applier_aihawk/blob/main/src/aihawk_easy_applier.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_entry,node_settings,node_secrets,node_facade,node_browser,node_auth toneBlue
class node_manager,node_job toneAmber
class node_applier,node_resume,node_tracking toneMint
class node_profile,node_llm,node_prompts toneRose
class node_user,node_linkedin,node_llm_service toneIndigo
```

## Components

### Setup and orchestration

- [CLI startup](https://github.com/11844/auto_jobs_applier_aihawk/blob/main/main.py): `main.py`
- [Search settings](https://github.com/11844/auto_jobs_applier_aihawk/blob/main/data_folder/config.yaml): `data_folder/config.yaml`
- [API credentials](https://github.com/11844/auto_jobs_applier_aihawk/blob/main/data_folder/secrets.yaml): `data_folder/secrets.yaml`
- [Bot facade](https://github.com/11844/auto_jobs_applier_aihawk/blob/main/src/aihawk_bot_facade.py): `src/aihawk_bot_facade.py`
- [Chrome browser](https://github.com/11844/auto_jobs_applier_aihawk/blob/main/src/utils.py): `src/utils.py`
- [Login and session](https://github.com/11844/auto_jobs_applier_aihawk/blob/main/src/aihawk_authenticator.py): `src/aihawk_authenticator.py`

### Job discovery

- [Job search manager](https://github.com/11844/auto_jobs_applier_aihawk/blob/main/src/aihawk_job_manager.py): `src/aihawk_job_manager.py`
- [Job record](https://github.com/11844/auto_jobs_applier_aihawk/blob/main/src/job.py): `src/job.py`

### Application workflow

- [Easy Apply automation](https://github.com/11844/auto_jobs_applier_aihawk/blob/main/src/aihawk_easy_applier.py): `src/aihawk_easy_applier.py`
- [Tailored resume](https://github.com/11844/auto_jobs_applier_aihawk/blob/main/src/aihawk_easy_applier.py): `src/aihawk_easy_applier.py`
- [Application tracking](https://github.com/11844/auto_jobs_applier_aihawk/blob/main/src/aihawk_easy_applier.py): `src/aihawk_easy_applier.py`

### Profile and AI

- [Application profile](https://github.com/11844/auto_jobs_applier_aihawk/blob/main/src/job_application_profile.py): `src/job_application_profile.py`
- [LLM manager](https://github.com/11844/auto_jobs_applier_aihawk/blob/main/src/llm/llm_manager.py): `src/llm/llm_manager.py`
- [Prompt templates](https://github.com/11844/auto_jobs_applier_aihawk/blob/main/src/strings.py): `src/strings.py`

### Other components

- **Job seeker**
- **LinkedIn**
- **LLM provider**

## Connections

- Job seeker → CLI startup: starts (evidence: `README.md`)
- CLI startup → Search settings: loads (evidence: `main.py`)
- CLI startup → API credentials: loads (evidence: `main.py`)
- CLI startup → Application profile: initializes (evidence: `main.py`)
- CLI startup → Bot facade: configures (evidence: `main.py`)
- CLI startup → LLM manager: initializes (evidence: `main.py`)
- Bot facade → Login and session: starts login (evidence: `src/aihawk_bot_facade.py`)
- Bot facade → Easy Apply automation: starts search or apply (evidence: `src/aihawk_bot_facade.py`)
- Login and session → Chrome browser: uses
- Login and session → LinkedIn: authenticates with (evidence: `src/aihawk_authenticator.py`)
- Job search manager → LinkedIn: searches jobs (evidence: `README.md`)
- Job search manager → Job record: creates records (evidence: `src/aihawk_job_manager.py`)
- Job search manager → Easy Apply automation: delegates applications (evidence: `src/aihawk_job_manager.py`)
- Easy Apply automation → LinkedIn: submits applications (evidence: `src/aihawk_easy_applier.py`)
- Easy Apply automation → LLM manager: requests answers
- LLM manager → Prompt templates: uses templates (evidence: `src/llm/llm_manager.py`)
- LLM manager → LLM provider: invokes model
- Easy Apply automation → Tailored resume: uploads documents (evidence: `src/aihawk_easy_applier.py`)
- Easy Apply automation → Application tracking: records answers (evidence: `src/aihawk_easy_applier.py`)
- Application profile → LLM manager: provides response context
