# pillow34/aihawk architecture

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

- Interactive diagram: https://gitdiagram.com/pillow34/aihawk
- Repository: https://github.com/pillow34/aihawk

## Overview

AIHawk automates a job seeker’s LinkedIn search and application workflow: configure criteria and profile data, authenticate, find and filter jobs, personalize application responses, and submit applications. The central runtime is coordinated by the bot facade and job manager, with browser automation and LLM-backed answer generation. The README documents tailored resumes, application tracking, and filtering capabilities beyond the sampled implementation excerpts; those branches are represented at the nearest supported source locations. Arrows follow shown calls, SOURCE INDEX references, or README statements; unsampled wiring is not inferred.

Main entry points: [`main.py`](https://github.com/pillow34/aihawk/blob/main/main.py) (CLI Entry), [`src/aihawk_job_manager.py`](https://github.com/pillow34/aihawk/blob/main/src/aihawk_job_manager.py) (Job Manager), [`src/aihawk_easy_applier.py`](https://github.com/pillow34/aihawk/blob/main/src/aihawk_easy_applier.py) (Easy Apply), [`src/aihawk_bot_facade.py`](https://github.com/pillow34/aihawk/blob/main/src/aihawk_bot_facade.py) (Bot Facade)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_setup["Setup and Profile"]
  node_entry["CLI Entry<br/>[main.py]"]
  node_config["Configuration<br/>[main.py]"]
  node_settings["Runtime Settings<br/>[app_config.py]"]
  node_profile["Application Profile"]
end

subgraph group_coord["Bot Coordination"]
  node_facade["Bot Facade"]
end

subgraph group_search["Job Search and Apply"]
  node_manager["Job Manager"]
  node_job["Job Record<br/>[job.py]"]
  node_applier["Easy Apply"]
  node_tracking["Application Tracking"]
end

subgraph group_personal["AI Personalization"]
  node_resume["Tailored Resume"]
  node_answerer["LLM Answerer<br/>[llm_manager.py]"]
  node_prompts["Prompt Templates<br/>[strings.py]"]
end

subgraph group_runtime["Browser Runtime"]
  node_auth["LinkedIn Login"]
  node_browser["Browser Utilities<br/>[utils.py]"]
end

node_seeker(("Job Seeker"))
node_linkedin["LinkedIn"]
node_llmservice["LLM Providers"]

node_seeker -->|"runs"| node_entry
node_entry -->|"validates"| node_config
node_entry -->|"loads profile"| node_profile
node_entry -->|"configures"| node_facade
node_entry -->|"creates"| node_answerer
node_entry -->|"starts"| node_manager
node_facade -->|"starts login"| node_auth
node_facade -->|"starts applying"| node_manager
node_facade -->|"sets profile"| node_profile
node_manager -->|"creates"| node_job
node_manager -->|"delegates"| node_applier
node_manager -->|"reads"| node_settings
node_manager -->|"tracks applications"| node_tracking
node_applier -->|"requests answers"| node_answerer
node_applier -->|"uploads documents"| node_resume
node_answerer -->|"uses templates"| node_prompts
node_answerer -.->|"queries"| node_llmservice
node_auth -->|"authenticates"| node_linkedin
node_applier -->|"submits applications"| node_linkedin
node_manager -->|"uses utilities"| node_browser
node_applier -->|"uses utilities"| node_browser
node_entry -->|"configures browser"| node_browser
node_entry -->|"configures logging"| node_settings

click node_entry "https://github.com/pillow34/aihawk/blob/main/main.py"
click node_config "https://github.com/pillow34/aihawk/blob/main/main.py"
click node_settings "https://github.com/pillow34/aihawk/blob/main/app_config.py"
click node_profile "https://github.com/pillow34/aihawk/blob/main/src/job_application_profile.py"
click node_facade "https://github.com/pillow34/aihawk/blob/main/src/aihawk_bot_facade.py"
click node_auth "https://github.com/pillow34/aihawk/blob/main/src/aihawk_authenticator.py"
click node_manager "https://github.com/pillow34/aihawk/blob/main/src/aihawk_job_manager.py"
click node_job "https://github.com/pillow34/aihawk/blob/main/src/job.py"
click node_applier "https://github.com/pillow34/aihawk/blob/main/src/aihawk_easy_applier.py"
click node_tracking "https://github.com/pillow34/aihawk/blob/main/src/aihawk_job_manager.py"
click node_resume "https://github.com/pillow34/aihawk/tree/main/src"
click node_answerer "https://github.com/pillow34/aihawk/blob/main/src/llm/llm_manager.py"
click node_prompts "https://github.com/pillow34/aihawk/blob/main/src/strings.py"
click node_browser "https://github.com/pillow34/aihawk/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_entry,node_config,node_settings,node_profile toneBlue
class node_facade toneAmber
class node_manager,node_job,node_applier,node_tracking toneMint
class node_resume,node_answerer,node_prompts toneRose
class node_auth,node_browser,node_seeker,node_linkedin,node_llmservice toneIndigo
```

## Components

### Setup and Profile

- [CLI Entry](https://github.com/pillow34/aihawk/blob/main/main.py): `main.py`
- [Configuration](https://github.com/pillow34/aihawk/blob/main/main.py): `main.py`
- [Runtime Settings](https://github.com/pillow34/aihawk/blob/main/app_config.py): `app_config.py`
- [Application Profile](https://github.com/pillow34/aihawk/blob/main/src/job_application_profile.py): `src/job_application_profile.py`

### Bot Coordination

- [Bot Facade](https://github.com/pillow34/aihawk/blob/main/src/aihawk_bot_facade.py): `src/aihawk_bot_facade.py`

### Job Search and Apply

- [Job Manager](https://github.com/pillow34/aihawk/blob/main/src/aihawk_job_manager.py): `src/aihawk_job_manager.py`
- [Job Record](https://github.com/pillow34/aihawk/blob/main/src/job.py): `src/job.py`
- [Easy Apply](https://github.com/pillow34/aihawk/blob/main/src/aihawk_easy_applier.py): `src/aihawk_easy_applier.py`
- [Application Tracking](https://github.com/pillow34/aihawk/blob/main/src/aihawk_job_manager.py): `src/aihawk_job_manager.py`

### AI Personalization

- [Tailored Resume](https://github.com/pillow34/aihawk/tree/main/src): `src`
- [LLM Answerer](https://github.com/pillow34/aihawk/blob/main/src/llm/llm_manager.py): `src/llm/llm_manager.py`
- [Prompt Templates](https://github.com/pillow34/aihawk/blob/main/src/strings.py): `src/strings.py`

### Browser Runtime

- [LinkedIn Login](https://github.com/pillow34/aihawk/blob/main/src/aihawk_authenticator.py): `src/aihawk_authenticator.py`
- [Browser Utilities](https://github.com/pillow34/aihawk/blob/main/src/utils.py): `src/utils.py`

### Other components

- **Job Seeker**
- **LinkedIn**
- **LLM Providers**

## Connections

- Job Seeker → CLI Entry: runs (evidence: `README.md`)
- CLI Entry → Configuration: validates (evidence: `main.py`)
- CLI Entry → Application Profile: loads profile (evidence: `main.py`)
- CLI Entry → Bot Facade: configures (evidence: `main.py`)
- CLI Entry → LLM Answerer: creates (evidence: `main.py`)
- CLI Entry → Job Manager: starts (evidence: `main.py`)
- Bot Facade → LinkedIn Login: starts login (evidence: `src/aihawk_bot_facade.py`)
- Bot Facade → Job Manager: starts applying (evidence: `src/aihawk_bot_facade.py`)
- Bot Facade → Application Profile: sets profile (evidence: `src/aihawk_bot_facade.py`)
- Job Manager → Job Record: creates (evidence: `src/aihawk_job_manager.py`)
- Job Manager → Easy Apply: delegates (evidence: `src/aihawk_job_manager.py`)
- Job Manager → Runtime Settings: reads (evidence: `src/aihawk_job_manager.py`)
- Job Manager → Application Tracking: tracks applications (evidence: `README.md`)
- Easy Apply → LLM Answerer: requests answers (evidence: `src/aihawk_easy_applier.py`)
- Easy Apply → Tailored Resume: uploads documents (evidence: `README.md`)
- LLM Answerer → Prompt Templates: uses templates (evidence: `src/llm/llm_manager.py`)
- LLM Answerer → LLM Providers: queries (evidence: `README.md`)
- LinkedIn Login → LinkedIn: authenticates (evidence: `src/aihawk_authenticator.py`)
- Easy Apply → LinkedIn: submits applications (evidence: `README.md`)
- Job Manager → Browser Utilities: uses utilities (evidence: `src/aihawk_job_manager.py`)
- Easy Apply → Browser Utilities: uses utilities (evidence: `src/aihawk_easy_applier.py`)
- CLI Entry → Browser Utilities: configures browser (evidence: `main.py`)
- CLI Entry → Runtime Settings: configures logging
