# bajajharsha/recruitment-process-automation-tool architecture

> Architecture diagram of the GitHub repository bajajharsha/recruitment-process-automation-tool, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-03-31). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/bajajharsha/recruitment-process-automation-tool
- Repository: https://github.com/bajajharsha/recruitment-process-automation-tool

## Overview

##### Project Type & Purpose
- This is a full-stack application aimed at automating parts of the recruitment process. Its functionality is twofold: matching resumes to job descriptions and analyzing interview video content for insights.
- The backend (API services) focuses on processing and analysis (e.g., text extraction, NLP, video analysis, similarity search using vector stores), while the frontend is a Streamlit-based user interface to facilitate user interactions with these features.

##### Analyzing the File Structure
- Top-Level Directories:
- “StreamlitApp”: Contains scripts like AnalyzeVideo.py, JobMatchingSystem.py, home.py, and streamlit_app.py that define the web interface where users interact with the tool.
- Configuration & Environment:
- The .env file holds environment variables including API keys for external services.
- The README and requirements.txt indicate dependencies like fastapi/uvicorn (for backend API services) and streamlit (for the UI), as well as several third-party services (e.g., AssemblyAI, Pinecone, Google Generative AI).

##### Key Components and Their Interactions
- Frontend Component:
- Represented by the StreamlitApp folder.
- Responsible for user interactions (uploading resumes, job descriptions, videos).
- Initiates calls to the backend API for processing analysis.
- Backend/API Component:
- Contained in the Api directory.
- Comprises multiple functional modules:
▪ Video analysis, text extraction, NLP analysis, similarity search and vector store management.
▪ The file app.py likely wraps up these functionalities and runs a FastAPI server with uvicorn to serve API requests.
- External Services & Dependencies:
- External APIs and libraries are integrated for language processing (e.g., langchain, sentence-transformers), video processing (moviepy), and cloud-based analysis (AssemblyAI, Google Generative AI, Pinecone).

##### Detailed Elements
- Each component should be clearly labeled (e.g., “Streamlit Frontend”, “Resume Matching API”, “Video Analysis API”, “NLP Processing Module”).
- User interactions: uploads resume, job description, video → StreamlitApp.
- StreamlitApp making HTTP calls to the API endpoints in the Api folder.
- API modules processing data and then reaching out to external APIs for advanced analysis.
- Adding brief notes on each component to explain its role.

## Diagram (Mermaid)

```mermaid
graph TD
    %% User Interaction
    U("User Browser"):::user

    %% Frontend Layer
    subgraph "Frontend Layer"
        FE("Streamlit Frontend"):::frontend
        FE_Video("Video Analysis UI"):::frontend
    end

    %% Backend Layer
    subgraph "Backend Layer"
        API("API Server (FastAPI)"):::backend
        CFG("Environment Config (.env)"):::config
        API ---|"uses"| CFG

        subgraph "Processing Modules"
            VA("Video Analysis Module"):::module
            TE("Text Extraction Module"):::module
            NLP("NLP Processing Module"):::module
            SS("Similarity Search Module"):::module
            VS("Vector Store Management Module"):::module
            LLM("LLM Integration Module"):::module
        end

        API -->|"calls"| VA
        API -->|"calls"| TE
        API -->|"calls"| NLP
        API -->|"calls"| SS
        API -->|"calls"| VS
        API -->|"calls"| LLM
    end

    %% External Services Layer
    subgraph "External Services"
        EXT("External Services (AssemblyAI, Pinecone, Google Generative AI, langchain, sentence-transformers, moviepy)"):::external
    end

    %% Connections
    U -->|"interacts"| FE
    FE -->|"triggers API request"| API
    FE_Video -->|"initiates video analysis"| API

    VA -->|"analyzes"| EXT
    TE -->|"extracts"| EXT
    NLP -->|"processes"| EXT
    SS -->|"searches"| EXT
    VS -->|"manages"| EXT
    LLM -->|"generates"| EXT

    %% Click Events
    click FE "https://github.com/bajajharsha/recruitment-process-automation-tool/tree/main/FINAL-PROJECT/StreamlitApp"
    click API "https://github.com/bajajharsha/recruitment-process-automation-tool/blob/main/FINAL-PROJECT/Api/app.py"
    click VA "https://github.com/bajajharsha/recruitment-process-automation-tool/blob/main/FINAL-PROJECT/Api/analyzeVideo.py"
    click FE_Video "https://github.com/bajajharsha/recruitment-process-automation-tool/blob/main/FINAL-PROJECT/StreamlitApp/AnalyzeVideo.py"
    click TE "https://github.com/bajajharsha/recruitment-process-automation-tool/blob/main/FINAL-PROJECT/Api/textExtraction.py"
    click NLP "https://github.com/bajajharsha/recruitment-process-automation-tool/blob/main/FINAL-PROJECT/Api/nlp.py"
    click SS "https://github.com/bajajharsha/recruitment-process-automation-tool/blob/main/FINAL-PROJECT/Api/similaritySearch.py"
    click VS "https://github.com/bajajharsha/recruitment-process-automation-tool/blob/main/FINAL-PROJECT/Api/vectorStore.py"
    click LLM "https://github.com/bajajharsha/recruitment-process-automation-tool/blob/main/FINAL-PROJECT/Api/finalLLM.py"
    click CFG "https://github.com/bajajharsha/recruitment-process-automation-tool/blob/main/.env"

    %% Styles
    classDef frontend fill:#AED6F1,stroke:#1F618D,stroke-width:2px;
    classDef backend fill:#ABEBC6,stroke:#239B56,stroke-width:2px;
    classDef module fill:#F9E79F,stroke:#B7950B,stroke-width:2px;
    classDef external fill:#F5B7B1,stroke:#C0392B,stroke-width:2px;
    classDef config fill:#D2B4DE,stroke:#7D3C98,stroke-width:2px;
    classDef user fill:#FAD7A0,stroke:#D35400,stroke-width:2px;
```
