# georgeknapendatech/linkedin_auto_jobs_applier_with_ai_fast architecture

> Architecture diagram of the GitHub repository georgeknapendatech/linkedin_auto_jobs_applier_with_ai_fast, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-05-12). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/georgeknapendatech/linkedin_auto_jobs_applier_with_ai_fast
- Repository: https://github.com/georgeknapendatech/linkedin_auto_jobs_applier_with_ai_fast

## Overview

##### Project type and purpose
- LinkedIn_AIHawk is an open‐source, command-line automation tool (a “bot”) that accelerates and personalizes your LinkedIn job search and application process. It leverages browser automation (via Selenium/ChromeDriver), OpenAI’s GPT API, and dynamic resume generation to auto-fill forms, tailor resumes, and submit “Easy Apply” applications at scale.

##### File structure
Top-level files:
- main.py    – entry point and CLI argument parsing
- gpt.py    – wrappers around OpenAI API for AI-driven text generation
- linkedIn_authenticator.py – logs into LinkedIn via Selenium
- linkedIn_bot_facade.py  – high-level façade coordinating authentication, search, application
- linkedIn_easy_applier.py – implements “Easy Apply” form interactions
- linkedIn_job_manager.py – orchestrates job search, filtering, and queuing
- resume.py    – builds and renders tailored resume PDFs using template scripts
- utils.py, strings.py  – shared helper functions and constant strings
- data_folder/   – user’s secrets.yaml, config.yaml, plain_text_resume.yaml (runtime inputs)
- resume_template/ – Node.js scripts (casual_markdown.js, reorganizeHeader.js) and CSS for HTML→PDF
- documentation.md, README.md, requirements.txt, LICENSE

Patterns & organization:
- Facade pattern in linkedIn_bot_facade.py
- Separation of concerns: authentication, job management, application, resume generation, GPT integration
- External configs (YAML) isolate sensitive and user-specific data
- Template directory uses a mini Node.js pipeline for HTML/CSS→PDF transform

##### Insights from the README
- Core flows: configure your bot via YAML files; run main.py; bot logs into LinkedIn; scans and filters jobs; generates AI-personlized text; generates or uses a PDF resume; auto-submits applications.
- Emphasis on “data_folder_example” to illustrate correct inputs.
- External dependencies: Python packages (Selenium, OpenAI), Chrome & ChromeDriver, Node.js for resume templates.

To capture the architecture, break the system into these main components:
A. User Interface (CLI)
- Accepts flags (e.g., --resume)
- Reads and validates config/data folder
B. Configuration & Data Store
- YAML file loader for secrets.yaml, config.yaml, plain_text_resume.yaml
- Example data folder for reference
C. Bot Controller / Facade
- linkedIn_bot_facade.py orchestrates end-to-end workflow
D. Authentication Service
- linkedIn_authenticator.py uses Selenium/ChromeDriver to log in
E. Job Manager
- linkedIn_job_manager.py handles search criteria, continuous scanning, blacklisting
F. Application Service
- linkedIn_easy_applier.py executes “Easy Apply” flows, form autofill
G. GPT Service
- gpt.py communicates with OpenAI API for question responses and personalization
H. Resume Generation
- resume.py composes HTML via plain_text_resume.yaml
- Calls Node.js scripts (casual_markdown.js, reorganizeHeader.js) + CSS → outputs PDF
I. Browser Automation
- Selenium + ChromeDriver as the runtime engine for all LinkedIn interactions
J. External Services
- LinkedIn Web UI
- OpenAI API

Relationships & data flows:
1. CLI → loads Configuration & Data
2. CLI → Bot Controller
3. Bot Controller → Authentication Service → LinkedIn
4. Bot Controller → Job Manager → LinkedIn (search pages)
5. Job Manager → Application Service → Browser Automation → LinkedIn (forms)
6. Application Service → GPT Service for dynamic text
7. Bot Controller → Resume Generation → Node.js template pipeline → PDF
8. Application Service → attaches PDF + submits

Architectural patterns & principles:
- Facade (linkedIn_bot_facade.py) to hide complexity
- Modular services: each major concern in its own module
- Configuration-driven behavior via YAML (separation of code & data)
- External template pipeline (Node.js) for resume styling

##### Key elements to capture
- Clear component labels and boundaries
- Data/config sources shown as separate nodes

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Data/Config Layer
    subgraph "Configuration & Data Store"
        direction TB
        CFG1[(config.yaml)]:::data
        CFG2[(plain_text_resume.yaml)]:::data
        CFG3[(secrets.yaml)]:::data
        CFG4[(data_folder_example/)]:::data
    end

    %% External Services
    subgraph "External Services"
        direction TB
        LI[(LinkedIn Web UI)]:::external
        OA[(OpenAI API)]:::external
    end

    %% Core Services
    subgraph "Core Services"
        direction TB
        CLI["User Interface (CLI)"]:::core
        BotFacade["Bot Controller / Facade"]:::core
        Auth["Authentication Service"]:::core
        JobMgr["Job Manager"]:::core
        Applier["Application Service (Easy Apply)"]:::core
        GPTService["GPT Service"]:::ai
        ResumeGen["Resume Generation"]:::ai
    end

    %% Resume Template Pipeline
    subgraph "Resume Template Pipeline"
        direction TB
        Casual["casual_markdown.js"]:::ai
        Reorg["reorganizeHeader.js"]:::ai
        CSS["resume.css"]:::ai
        PDF["Generated PDF Resume"]:::ai
    end

    %% Browser Automation Runtime
    BrowserAuto["Selenium/ChromeDriver"]:::external

    %% Flows
    CLI -->|"loads configs"| CFG1
    CLI --> CFG2
    CLI --> CFG3
    CLI --> CFG4
    CLI -->|"starts workflow"| BotFacade

    BotFacade -->|"login credentials"| Auth
    Auth -->|"uses Selenium"| BrowserAuto
    BrowserAuto --> LI

    BotFacade -->|"search criteria"| JobMgr
    JobMgr -->|"requests page"| BrowserAuto
    JobMgr -->|"search results"| BotFacade

    BotFacade --> ResumeGen
    ResumeGen --> Casual
    ResumeGen --> Reorg
    ResumeGen --> CSS
    CSS --> PDF

    JobMgr -->|"job to apply"| Applier
    Applier -->|"form fill"| BrowserAuto
    Applier -->|"application payload + PDF"| BrowserAuto
    BrowserAuto --> LI

    Applier -->|"requests dynamic text"| GPTService
    GPTService -->|"API calls"| OA

    %% Click Events
    click CLI "https://github.com/georgeknapendatech/linkedin_auto_jobs_applier_with_ai_fast/blob/dev/us/smart-fast/main.py"
    click CFG1 "https://github.com/georgeknapendatech/linkedin_auto_jobs_applier_with_ai_fast/blob/dev/us/smart-fast/data_folder/config.yaml"
    click CFG2 "https://github.com/georgeknapendatech/linkedin_auto_jobs_applier_with_ai_fast/blob/dev/us/smart-fast/data_folder/plain_text_resume.yaml"
    click CFG3 "https://github.com/georgeknapendatech/linkedin_auto_jobs_applier_with_ai_fast/blob/dev/us/smart-fast/data_folder/secrets.yaml"
    click CFG4 "https://github.com/georgeknapendatech/linkedin_auto_jobs_applier_with_ai_fast/tree/dev/us/smart-fast/data_folder_example/"
    click BotFacade "https://github.com/georgeknapendatech/linkedin_auto_jobs_applier_with_ai_fast/blob/dev/us/smart-fast/linkedIn_bot_facade.py"
    click Auth "https://github.com/georgeknapendatech/linkedin_auto_jobs_applier_with_ai_fast/blob/dev/us/smart-fast/linkedIn_authenticator.py"
    click JobMgr "https://github.com/georgeknapendatech/linkedin_auto_jobs_applier_with_ai_fast/blob/dev/us/smart-fast/linkedIn_job_manager.py"
    click Applier "https://github.com/georgeknapendatech/linkedin_auto_jobs_applier_with_ai_fast/blob/dev/us/smart-fast/linkedIn_easy_applier.py"
    click GPTService "https://github.com/georgeknapendatech/linkedin_auto_jobs_applier_with_ai_fast/blob/dev/us/smart-fast/gpt.py"
    click ResumeGen "https://github.com/georgeknapendatech/linkedin_auto_jobs_applier_with_ai_fast/blob/dev/us/smart-fast/resume.py"
    click Casual "https://github.com/georgeknapendatech/linkedin_auto_jobs_applier_with_ai_fast/blob/dev/us/smart-fast/resume_template/casual_markdown.js"
    click Reorg "https://github.com/georgeknapendatech/linkedin_auto_jobs_applier_with_ai_fast/blob/dev/us/smart-fast/resume_template/reorganizeHeader.js"
    click CSS "https://github.com/georgeknapendatech/linkedin_auto_jobs_applier_with_ai_fast/blob/dev/us/smart-fast/resume_template/resume.css"

    %% Styles
    classDef data fill:#d4f7d4,stroke:#1f772c,color:#1f772c
    classDef core fill:#d0e7ff,stroke:#1b4f9c,color:#1b4f9c
    classDef ai fill:#ffe7b2,stroke:#cc7a00,color:#cc7a00
    classDef external fill:#e0e0e0,stroke:#7a7a7a,color:#7a7a7a
```
