# madhuvod/ai-recruitment-agent-team architecture

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

- Interactive diagram: https://gitdiagram.com/madhuvod/ai-recruitment-agent-team
- Repository: https://github.com/madhuvod/ai-recruitment-agent-team

## Overview

##### Project type and purpose
- This is a single-page, full-stack “agentic” Streamlit application for automating technical hiring tasks.
- The README explains three specialized agents (Resume Analyzer, Email Communication, Interview Scheduler) working together under a central orchestrator in a Streamlit UI.

##### File structure
- Top level:
- ai_recruitment_agent_team.py – the main Streamlit app orchestrating all agents
- requirements.txt – dependency list
- README.md – project overview and instructions
- There are no separate “frontend/” or “backend/” folders; both UI and business logic live in one script.

##### README for additional insights
- The Technical Stack section names key frameworks/libraries: Phidata, OpenAI GPT-4o, Zoom API, EmailTools from Phidata, PyPDF2, pytz, Streamlit Session State.
- System Components section lists each agent’s responsibilities.

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% UI Layer
    UI["Streamlit UI"]:::ui
    click UI "https://github.com/madhuvod/ai-recruitment-agent-team/blob/main/ai_recruitment_agent_team.py"

    %% Orchestrator and Agents
    Orchestrator["Orchestrator / Controller"]:::agent
    click Orchestrator "https://github.com/madhuvod/ai-recruitment-agent-team/blob/main/ai_recruitment_agent_team.py"
    ResumeAgent["Resume Analyzer Agent"]:::agent
    click ResumeAgent "https://github.com/madhuvod/ai-recruitment-agent-team/blob/main/ai_recruitment_agent_team.py"
    EmailAgent["Email Communication Agent"]:::agent
    click EmailAgent "https://github.com/madhuvod/ai-recruitment-agent-team/blob/main/ai_recruitment_agent_team.py"
    SchedulerAgent["Interview Scheduler Agent"]:::agent
    click SchedulerAgent "https://github.com/madhuvod/ai-recruitment-agent-team/blob/main/ai_recruitment_agent_team.py"

    %% Utilities
    PDF["PyPDF2 (PDF Parsing Utility)"]:::util
    click PDF "https://github.com/madhuvod/ai-recruitment-agent-team/blob/main/ai_recruitment_agent_team.py"
    Timezone["pytz (Timezone Handling)"]:::util
    click Timezone "https://github.com/madhuvod/ai-recruitment-agent-team/blob/main/ai_recruitment_agent_team.py"
    SessionState["Session State Management"]:::ui
    click SessionState "https://github.com/madhuvod/ai-recruitment-agent-team/blob/main/ai_recruitment_agent_team.py"

    %% External Services
    subgraph "Third-Party Services"
        GPTAPI["OpenAI GPT-4o API"]:::external
        click GPTAPI "https://github.com/madhuvod/ai-recruitment-agent-team/blob/main/ai_recruitment_agent_team.py"
        ZoomAPI["Zoom API"]:::external
        click ZoomAPI "https://github.com/madhuvod/ai-recruitment-agent-team/blob/main/ai_recruitment_agent_team.py"
        GmailSMTP["Gmail SMTP (EmailTools)"]:::external
        click GmailSMTP "https://github.com/madhuvod/ai-recruitment-agent-team/blob/main/ai_recruitment_agent_team.py"
    end

    %% Documentation
    README["Project Overview & Instructions"]:::doc
    click README "https://github.com/madhuvod/ai-recruitment-agent-team/blob/main/README.md"
    Requirements["Dependency Specifications"]:::doc
    click Requirements "https://github.com/madhuvod/ai-recruitment-agent-team/blob/main/requirements.txt"

    %% Flow
    UI -->|"upload resume"| Orchestrator
    Orchestrator -->|"invoke analysis"| ResumeAgent
    ResumeAgent -->|"parse PDF"| PDF
    ResumeAgent -->|"assess skills"| GPTAPI
    GPTAPI -->|"analysis result"| ResumeAgent
    ResumeAgent -->|"return analysis"| Orchestrator

    Orchestrator -->|"pass"| SchedulerAgent
    Orchestrator -->|"fail"| EmailAgent

    SchedulerAgent -->|"create meeting"| ZoomAPI
    ZoomAPI -->|"Zoom link"| SchedulerAgent
    SchedulerAgent -->|"return link"| Orchestrator

    EmailAgent -->|"draft & send"| GmailSMTP
    GmailSMTP -->|"email sent"| EmailAgent
    EmailAgent -->|"notify"| Orchestrator

    Orchestrator -->|"update status"| SessionState
    SessionState -->|"display status"| UI

    %% Documentation Links
    UI --> README
    UI --> Requirements

    classDef ui fill:#ADD8E6,stroke:#000,stroke-width:1px
    classDef agent fill:#90EE90,stroke:#000,stroke-width:1px
    classDef external fill:#FFA500,stroke:#000,stroke-width:1px
    classDef util fill:#D3D3D3,stroke:#000,stroke-width:1px
    classDef doc fill:#EEEEEE,stroke:#000,stroke-width:1px
```
