# himanshu-skid19/pathfinder-ai-enhanced-resumes architecture

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

- Interactive diagram: https://gitdiagram.com/himanshu-skid19/pathfinder-ai-enhanced-resumes
- Repository: https://github.com/himanshu-skid19/pathfinder-ai-enhanced-resumes

## Overview

##### Project type and purpose
- From the README and file tree, this is a single-codebase AI-powered resume parsing and cover-letter generation tool with a Streamlit UI (“app.py”), backed by a FAISS vector store for semantic search, and templating modules that render LaTeX outputs. It is not a multi-service microservice topology but a monolithic “full-stack” data-science application.

##### File structure
- Top-level files:
- app.py – Streamlit front-end and orchestration
- create_vector_store.py – indexing resumes into FAISS
- read_data.py – parsing and preprocessing resumes
- prompts.py, llm.py – prompting logic and OpenAI API wrapper
- iitg_template.py, latex_template.py – rendering templates
- imports.py – shared imports/config
- test_data.py – sample or unit tests
- requirements.txt – dependencies (streamlit, faiss, openai, etc.)
- resumes/ – raw PDF resumes served as data

##### README for additional insights
- It clarifies prerequisites (WSL for FAISS), the launch steps, and a brief “Project Architecture” listing the same files.

##### Key details to capture
- The conditional step: vector store build vs. reuse
- The synchronous LLM call and templating sequence
- The final output artifact (LaTeX/PDF)

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% UI Layer
    subgraph "UI Layer"
        UI["Streamlit UI Orchestrator"]:::ui
        IMPORTS["imports.py"]:::shared
    end

    %% Data Layer
    subgraph "Data Layer"
        RESUMES[(Raw Resumes Folder)]:::data
        READ["read_data.py"]:::process
        RESUMES --> READ
    end

    %% Vector Layer
    subgraph "Vector Store Service"
        CREATE["create_vector_store.py"]:::process
        FAISS[(FAISS Vector Store)]:::data
        READ --> CREATE
        CREATE --> FAISS
    end

    %% LLM Layer
    subgraph "LLM Service"
        PROMPTS["prompts.py"]:::process
        LLM_WRAPPER["llm.py"]:::process
        OPENAI((OpenAI API)):::external
        PROMPTS --> LLM_WRAPPER
        LLM_WRAPPER --> OPENAI
    end

    %% Template Layer
    subgraph "Template Renderer"
        IITG["iitg_template.py"]:::process
        LATEX["latex_template.py"]:::process
        IITG --> LATEX
    end

    %% Output Layer
    subgraph "Output Module"
        TEX[(output.tex)]:::artifact
        LOG[(output.log)]:::artifact
        LATEX --> TEX
        LATEX --> LOG
    end

    %% Dependency
    REQS["requirements.txt"]:::shared
    IMPORTS -.-> REQS

    %% Orchestration flows
    UI --> READ
    UI --> CREATE
    UI --> PROMPTS
    UI --> IITG
    UI --> TEX
    UI --> LOG

    %% Click Events
    click UI "https://github.com/himanshu-skid19/pathfinder-ai-enhanced-resumes/blob/main/app.py"
    click IMPORTS "https://github.com/himanshu-skid19/pathfinder-ai-enhanced-resumes/blob/main/imports.py"
    click RESUMES "https://github.com/himanshu-skid19/pathfinder-ai-enhanced-resumes/tree/main/resumes/"
    click READ "https://github.com/himanshu-skid19/pathfinder-ai-enhanced-resumes/blob/main/read_data.py"
    click CREATE "https://github.com/himanshu-skid19/pathfinder-ai-enhanced-resumes/blob/main/create_vector_store.py"
    click PROMPTS "https://github.com/himanshu-skid19/pathfinder-ai-enhanced-resumes/blob/main/prompts.py"
    click IITG "https://github.com/himanshu-skid19/pathfinder-ai-enhanced-resumes/blob/main/iitg_template.py"
    click LATEX "https://github.com/himanshu-skid19/pathfinder-ai-enhanced-resumes/blob/main/latex_template.py"
    click TEX "https://github.com/himanshu-skid19/pathfinder-ai-enhanced-resumes/blob/main/output.tex"
    click LOG "https://github.com/himanshu-skid19/pathfinder-ai-enhanced-resumes/blob/main/output.log"
    click REQS "https://github.com/himanshu-skid19/pathfinder-ai-enhanced-resumes/blob/main/requirements.txt"

    %% Styles
    classDef ui fill:#D0E6FF,stroke:#0366d6,stroke-width:1px
    classDef data fill:#E6F4EA,stroke:#2c662d,stroke-width:1px
    classDef process fill:#F0F0F0,stroke:#555555,stroke-width:1px
    classDef external fill:#FFEFD5,stroke:#d2691e,stroke-width:1px,stroke-dasharray: 5 5
    classDef artifact fill:#FFF5E6,stroke:#b8860b,stroke-width:1px
    classDef shared fill:#F5F5F5,stroke:#888888,stroke-width:1px,stroke-dasharray: 2 2
```
