# bharath0726/airecruitingagent architecture

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

- Interactive diagram: https://gitdiagram.com/bharath0726/airecruitingagent
- Repository: https://github.com/bharath0726/airecruitingagent

## Overview

##### Project Type & Purpose
- This project is a Streamlit-based full-service recruitment application that leverages multiple specialized AI agents to automate various hiring steps—from resume analysis to interview scheduling and communication. Its goal is to enhance and speed up the entire recruitment process through automation and intelligent decision-making.

##### File Structure
- The top-level files include two Python scripts (agent3.py and app.py) and requirements.txt, indicating that the app is lightweight and self-contained. The presence of a GitHub workflows directory suggests continuous integration/deployment practices.
- agent3.py is referenced in the README as the main entry point (using the command “streamlit run agent3.py”), while app.py might represent an alternative or legacy entry point.
- The minimalistic file structure indicates that most of the application’s logic and components are encapsulated in these scripts rather than being separated into multiple directories.

##### Key Components
a. User Interface (Streamlit Frontend):
- Represents the visual interface where recruiters and candidates interact.
- This component handles file uploads (resumes), displays ATS scores, and shows real-time feedback.

b. AI Agents:
- Resume Analyzer Agent:
- Processes resumes using ATS integration.
- Calculates match scores based on technical skills and experience.
- Generates feedback on candidate progress.
- Communication Agent:
- Drafts and sends professional emails (for selection or rejection).
- Manages follow-ups and communication consistency.
- Interview Scheduler Agent:
- Integrates with the Zoom API to schedule interviews.
- Manages calendar integration and timezone adjustments.
- Integrated ATS System:
- Provides an interface within the application to display and evaluate ATS scores.
- Enables data-driven decision-making based on candidate resumes.

c. External Integrations:
- OpenAI API (for leveraging GPT-4 models in analysis and feedback).
- Zoom API (for interview scheduling).
- Email Services (for sending automated emails; likely via configurations provided by the recruiter’s Gmail account).

d. Configuration & Deployment:
- Environment Setup: Managed via requirements.txt.
- CI/CD: The .github/workflows/main.yml file indicates automated testing and deployment.

- The Streamlit Frontend (UI) connects to each AI agent, indicating that user actions (e.g., resume upload) trigger respective agent processes.
- Each AI Agent communicates with its corresponding external service (e.g., Resume Analyzer with ATS, Interview Scheduler with Zoom).
- Data flows back to the UI, updating real-time feedback such as ATS scores and scheduling confirmations.
- Use labels to clearly name each component (e.g., "Resume Analyzer Agent", "Communication Agent", etc.).
- Components into logical subsystems: one for the main processing logic (the AI agents) and one for external integrations (OpenAI, Zoom, Email).

##### Relevant Technologies, Frameworks, and Design Principles
- Technology Stack:
- Framework: Streamlit.
- AI Model: OpenAI GPT-4.
- Integrations: Zoom API for scheduling, Email services for communication.
- Architectural Pattern:
- Although the project does not follow a heavy microservices or multi-directory structure, it is modular in that each agent handles a specific part of the recruitment process.
- Separation of concerns; for instance, the UI is distinct from the underlying business logic in the agents.

## Diagram (Mermaid)

```mermaid
flowchart TD
    subgraph "Internal Components"
        UI["Streamlit Frontend"]:::ui
        RA["Resume Analyzer Agent"]:::agent
        CA["Communication Agent"]:::agent
        ISch["Interview Scheduler Agent"]:::agent
        ISA["Integrated ATS System"]:::agent
    end

    subgraph "External Integrations"
        OAI["OpenAI API"]:::integration
        ZOOM["Zoom API"]:::integration
        EMAIL["Email Service"]:::integration
    end

    subgraph "Deployment & Config"
        ENV["Environment & Dependency Management"]:::deployment
        CI["CI/CD & Deployment Configurations"]:::deployment
    end

    %% UI triggers agents
    UI -->|"submitsResume"| RA
    UI -->|"initiatesCommunication"| CA
    UI -->|"requestsInterview"| ISch
    UI -->|"displaysATSScores"| ISA

    %% Resume Analyzer interactions
    RA -->|"evaluatesResume"| ISA
    RA -->|"analyzesResume"| OAI
    RA -->|"updatesFeedback"| UI

    %% Communication Agent interactions
    CA -->|"draftsEmail"| EMAIL
    CA -->|"sendsCommResult"| UI

    %% Interview Scheduler interactions
    ISch -->|"schedulesInterview"| ZOOM
    ISch -->|"confirmsInterview"| UI

    %% Integrated ATS System feedback
    ISA -->|"updatesATSScores"| UI

    %% Deployment influence
    ENV -->|"providesDependencies"| UI
    CI -->|"deploysApp"| UI

    %% Click Events for Internal Components and Deployment
    click UI "https://github.com/bharath0726/airecruitingagent/blob/main/agent3.py"
    click RA "https://github.com/bharath0726/airecruitingagent/blob/main/agent3.py"
    click CA "https://github.com/bharath0726/airecruitingagent/blob/main/agent3.py"
    click ISch "https://github.com/bharath0726/airecruitingagent/blob/main/agent3.py"
    click ISA "https://github.com/bharath0726/airecruitingagent/blob/main/agent3.py"

    %% Click Events for External Integrations
    click OAI "https://github.com/bharath0726/airecruitingagent/blob/main/agent3.py"
    click ZOOM "https://github.com/bharath0726/airecruitingagent/blob/main/agent3.py"
    click EMAIL "https://github.com/bharath0726/airecruitingagent/blob/main/agent3.py"

    %% Click Events for Deployment & Configuration
    click ENV "https://github.com/bharath0726/airecruitingagent/blob/main/requirements.txt"
    click CI "https://github.com/bharath0726/airecruitingagent/blob/main/.github/workflows/main.yml"

    %% Styles
    classDef ui fill:#ADD8E6,stroke:#000,stroke-width:2px;
    classDef agent fill:#90EE90,stroke:#000,stroke-width:2px;
    classDef integration fill:#FFD700,stroke:#000,stroke-width:2px;
    classDef deployment fill:#FFA07A,stroke:#000,stroke-width:2px;
```
