# manan025/evslm architecture

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

- Interactive diagram: https://gitdiagram.com/manan025/evslm
- Repository: https://github.com/manan025/evslm

## Overview

##### Project type and purpose
- From the README (“evsLM”) and the presence of two Jupyter notebooks (RAG.ipynb, main.ipynb) plus a small utility module (utils/helper.py), this is primarily a lightweight Python-based tool or library, explored and driven via notebooks. It appears to implement retrieval-augmented workflows or PDF processing (poppler is required).

##### File structure
- Top level:
- RAG.ipynb, main.ipynb – user-facing notebooks (UI/experimentation)
- pyproject.toml & uv.lock – Python packaging/config & locked dependencies
- utils/ – your core Python logic (helper.py)
- external requirement: poppler (PDF rendering tools)
- There is no separate frontend/backend or database service—this is a single-process, script-based tool.

##### README for additional insights
- The focus is on running code inside Jupyter, loading/processing data via helper.py, and leveraging poppler for PDF operations.

##### Components
a. Jupyter Notebook Clients (RAG.ipynb, main.ipynb)
b. Core Library (utils/helper.py, and any other modules installed via pyproject.toml)
c. External Dependencies:
– poppler CLI / library (PDF rendering)
– any other Python packages listed in pyproject.toml
d. Local File System (data input/output – e.g. PDFs, intermediate files)

##### Relationships & data flow
- Notebook → imports → Core Library (helper.py)
- Core Library → invokes → External Dependencies (poppler)
- Core Library ↔ reads/writes ↔ Local File System
- Notebook ↔ displays ↔ Data/results (plots, text)

##### Architectural patterns & principles
- Separation of concerns:
- “UI” layer in notebooks
- “Business logic” in utils/helper.py
- “Infrastructure” calls out to poppler and file system
- Modularity via Python packaging (pyproject.toml)
- Reproducibility via locked dependencies (uv.lock)

##### Detail
- Even though this is a small codebase, break out each piece: the two notebooks, the helper module, the poppler dependency, and the file system.
- Every flow: notebook → Python function → poppler → back to Python → notebook display.

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% UI Layer
    subgraph "UI Layer"
        NB1["RAG.ipynb"]:::ui
        NB2["main.ipynb"]:::ui
    end

    %% Logic Layer
    subgraph "Logic Layer"
        Helper["utils/helper.py"]:::logic
        Package["pyproject.toml"]:::config
        Lock["uv.lock"]:::config
        README["README.md"]:::config
    end

    %% Infrastructure Layer
    subgraph "Infrastructure Layer"
        Poppler["External PDF Processor (poppler)"]:::external
        FS["Local File System"]:::storage
    end

    %% Connections
    NB1 -->|"imports & calls"| Helper
    NB2 -->|"imports & calls"| Helper
    Helper -->|"invoke CLI"| Poppler
    Helper -->|"read/write PDF"| FS
    Poppler -->|"generates output files"| FS
    FS -->|"provides data"| Helper
    Helper -->|"returns results"| NB1
    Helper -->|"returns results"| NB2

    %% Click Events
    click NB1 "https://github.com/manan025/evslm/blob/main/RAG.ipynb"
    click NB2 "https://github.com/manan025/evslm/blob/main/main.ipynb"
    click Helper "https://github.com/manan025/evslm/blob/main/utils/helper.py"
    click Package "https://github.com/manan025/evslm/blob/main/pyproject.toml"
    click Lock "https://github.com/manan025/evslm/blob/main/uv.lock"
    click README "https://github.com/manan025/evslm/blob/main/README.md"

    %% Styles
    classDef ui fill:#E0F7FA,stroke:#006064,stroke-width:1px
    classDef logic fill:#E8F5E9,stroke:#1B5E20,stroke-width:1px
    classDef external fill:#FFF3E0,stroke:#E65100,stroke-width:1px
    classDef storage fill:#ECEFF1,stroke:#455A64,stroke-width:1px
    classDef config fill:#F3E5F5,stroke:#4A148C,stroke-width:1px
```
