# aashish2502/hire-helper architecture

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

- Interactive diagram: https://gitdiagram.com/aashish2502/hire-helper
- Repository: https://github.com/aashish2502/hire-helper

## Overview

##### Project type and purpose
- This is a full-stack AI-powered screening assistant built with Streamlit (frontend) and Python (backend utilities).
- Purpose: allow HR users to upload resumes, generate embeddings, store/retrieve them, and drive a conversational AI assistant via external LLM APIs (Groq API) with monitoring (LangSmith).

##### File structure
- Top-level:
- app/app.py       → Streamlit-driven UI entry point
- app/utils/embeddings.py  → embedding generation logic (Hugging Face + FAISS integration)
- app/utils/history.py     → session or conversation history management
- requirements.txt: third-party libraries (Streamlit, Transformers, FAISS, Groq, LangSmith)

##### README for deeper insights
- Frontend: Streamlit
- Conversational AI: Groq API for LLM calls; LangSmith for tracing/monitoring
- Embeddings & Retrieval: Hugging Face Transformers + FAISS vector store
- Backend pipeline: preprocess → embed → store → retrieve → augment LLM context → respond
- Monitoring: LangSmith logs queries, latencies, reliabilities

## Diagram (Mermaid)

```mermaid
flowchart TD
    User["User"]:::external

    subgraph "Frontend Layer"
      StreamlitUI["Streamlit UI"]:::ui
    end

    subgraph "Backend Services"
      EmbedSvc["Embeddings Service"]:::compute
      HistorySvc["History Service"]:::compute
      subgraph "Retrieval"
        FAISS["FAISS DB"]:::datastore
      end
    end

    Groq["Groq LLM API"]:::external
    LangSmith["LangSmith Monitor"]:::external

    User -->|"upload resume / ask query"| StreamlitUI
    StreamlitUI -->|"preprocess & embed"| EmbedSvc
    EmbedSvc -->|"store embeddings"| FAISS
    EmbedSvc -->|"retrieve embeddings"| FAISS
    FAISS -->|"embeddings data"| EmbedSvc
    StreamlitUI -->|"update session"| HistorySvc
    HistorySvc -->|"session data"| StreamlitUI
    StreamlitUI -->|"call LLM"| Groq
    Groq -->|"LLM response"| StreamlitUI

    StreamlitUI -.->|"log events"| LangSmith
    EmbedSvc -.->|"log embeddings"| LangSmith
    Groq -.->|"log API calls"| LangSmith

    click StreamlitUI "https://github.com/aashish2502/hire-helper/blob/main/app/app.py"
    click EmbedSvc "https://github.com/aashish2502/hire-helper/blob/main/app/utils/embeddings.py"
    click HistorySvc "https://github.com/aashish2502/hire-helper/blob/main/app/utils/history.py"
    click Groq "https://github.com/aashish2502/hire-helper/blob/main/app/app.py"
    click LangSmith "https://github.com/aashish2502/hire-helper/blob/main/app/app.py"

    classDef ui fill:#ADD8E6,stroke:#333,stroke-width:1px;
    classDef compute fill:#90EE90,stroke:#333,stroke-width:1px;
    classDef datastore fill:#FFA500,stroke:#333,stroke-width:1px;
    classDef external fill:#DDA0DD,stroke:#333,stroke-width:1px;
```
