# rooban-oss/agentic_ai_workshop architecture

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

- Interactive diagram: https://gitdiagram.com/rooban-oss/agentic_ai_workshop
- Repository: https://github.com/rooban-oss/agentic_ai_workshop

## Overview

##### Project type and purpose
- This repository (“Agentic_AI_Workshop”) is a collection of AI-agent mini-projects (from “Day 2” through “PersonalizedEducationAssistant” and “LogisticsOptimizationAgent,” etc.), capped by a “Final Hackathon” full-stack application.
- Each “Day X” folder or standalone agent (e.g. “LangGraph Math Agent,” “codeDebuggingAgent”) is a self-contained Python demo illustrating an AI workflow (RAG, ReAct, CRUD via Streamlit, data analysis, etc.).
- The “Final Hackathon” folder is a production-style full-stack system: a React/Vite frontend, an Express/Node.js backend (with MongoDB), plus a small Python agent service.

##### File structure
- Top-level folders:
- Day 2, Day 3, …, Day 9 – each contains either a zip archive or Python scripts and README.
- EDA_Multi-Agent Data Analysis System – Python main, docs.
- Final Hackathon – subdivided into backend/, frontend/, python/.
- Several standalone agent folders (e.g. LogisticsOptimizationAgent, PersonalizedEducationAssistant).
- The Final Hackathon backend uses MVC: controllers/, models/, middleware.js, configDB.js, index.js.
- Frontend is a React/Vite app under frontend/src with components, assets, CSS.
- The python/ folder under Final Hackathon houses a simple “agents.py” and “app.py” (likely a microservice).

##### README for additional insights
- The top-level README only lists assignment names and dates—no architecture details.
- Individual sub-projects sometimes include their own README describing purpose and dependencies (e.g. RAG has requirements.txt).

## Diagram (Mermaid)

```mermaid
flowchart TD
    subgraph "Workshop Container"
        direction TB

        subgraph "AI Agent Modules"
            direction TB
            D2["Day 2 Module (Python)"]:::backend
            D3["Day 3 RAG Agent"]:::backend
            D9["Day 9 Interview Panel (Streamlit)"]:::frontend
            EDA["EDA Multi-Agent System"]:::backend
            LGA["LangGraph Math Agent"]:::backend
            LO["Logistics Optimization Agent"]:::backend
            PEA["Personalized Education Assistant"]:::backend
            CDA["Code Debugging Agent"]:::backend
        end

        subgraph "Final Hackathon"
            direction TB

            subgraph Frontend
                direction TB
                FEentry["main.jsx"]:::frontend
                FERoot["App.jsx"]:::frontend
                UIComponents["UI Components"]:::frontend
                Assets["Assets & Styles"]:::frontend
            end

            subgraph Backend
                direction TB
                Index["index.js"]:::backend
                DBConf["configDB.js"]:::backend
                MW["middleware.js"]:::backend
                subgraph Controllers
                    direction TB
                    CandC["candidateController.js"]:::backend
                    DashC["dashboardController.js"]:::backend
                    RecC["recruiterController.js"]:::backend
                end
                subgraph Models
                    direction TB
                    ModFiles["candidateModel.js<br>jobModel.js<br>evaluationModel.js<br>etc."]:::backend
                end
            end

            subgraph "Database"
                direction TB
                Mongo["MongoDB"]:::database
            end

            subgraph "Python Agent Service"
                direction TB
                PyApp["app.py"]:::backend
                Agents["agents.py"]:::backend
            end
        end

        ExternalLLM["OpenAI API"]:::external
    end

    %% Relationships
    D2 -->|uses| ExternalLLM
    D3 -->|uses| ExternalLLM
    D9 -->|CRUD via Streamlit| D9
    EDA -->|analyzes CSV| EDA
    LGA -->|uses| ExternalLLM
    LO -->|uses| ExternalLLM
    PEA -->|uses| ExternalLLM
    CDA -->|uses| ExternalLLM

    FEentry -->|renders| FERoot
    FERoot -->|calls API| Index
    UIComponents -->|used by| FERoot
    Assets -->|loaded by| FERoot

    Index -->|loads DB config| DBConf
    Index -->|uses middleware| MW
    Index -->|routes to controllers| CandC
    Index -->|routes to controllers| DashC
    Index -->|routes to controllers| RecC
    CandC -->|queries| ModFiles
    DashC -->|queries| ModFiles
    RecC -->|queries| ModFiles

    Index -->|connects to| Mongo
    Index -->|calls| PyApp
    PyApp -->|invokes| Agents
    Agents -->|calls| ExternalLLM

    %% Click Events
    click FEentry "https://github.com/rooban-oss/agentic_ai_workshop/blob/main/Final Hackathon/frontend/src/main.jsx"
    click FERoot "https://github.com/rooban-oss/agentic_ai_workshop/blob/main/Final Hackathon/frontend/src/App.jsx"
    click UIComponents "https://github.com/rooban-oss/agentic_ai_workshop/tree/main/Final Hackathon/frontend/src/components"
    click Assets "https://github.com/rooban-oss/agentic_ai_workshop/tree/main/Final Hackathon/frontend/src/assets"
    click Index "https://github.com/rooban-oss/agentic_ai_workshop/blob/main/Final Hackathon/backend/index.js"
    click DBConf "https://github.com/rooban-oss/agentic_ai_workshop/blob/main/Final Hackathon/backend/db/configDB.js"
    click MW "https://github.com/rooban-oss/agentic_ai_workshop/blob/main/Final Hackathon/backend/middleware.js"
    click CandC "https://github.com/rooban-oss/agentic_ai_workshop/blob/main/Final Hackathon/backend/controllers/candidateController.js"
    click DashC "https://github.com/rooban-oss/agentic_ai_workshop/blob/main/Final Hackathon/backend/controllers/dashboardController.js"
    click RecC "https://github.com/rooban-oss/agentic_ai_workshop/blob/main/Final Hackathon/backend/controllers/recruiterController.js"
    click ModFiles "https://github.com/rooban-oss/agentic_ai_workshop/tree/main/Final Hackathon/backend/models"
    click Mongo "https://github.com/rooban-oss/agentic_ai_workshop/blob/main/Final Hackathon/backend/db/configDB.js"
    click PyApp "https://github.com/rooban-oss/agentic_ai_workshop/blob/main/Final Hackathon/python/app.py"
    click Agents "https://github.com/rooban-oss/agentic_ai_workshop/blob/main/Final Hackathon/python/agents.py"
    click EDA "https://github.com/rooban-oss/agentic_ai_workshop/blob/main/EDA_Multi-Agent Data Analysis System/main.py"
    click D3 "https://github.com/rooban-oss/agentic_ai_workshop/blob/main/Day 3/RAG/main.py"
    click LGA "https://github.com/rooban-oss/agentic_ai_workshop/blob/main/LangGraph Math Agent/main.py"
    click LO "https://github.com/rooban-oss/agentic_ai_workshop/blob/main/LogisticsOptimizationAgent/main.py"
    click PEA "https://github.com/rooban-oss/agentic_ai_workshop/blob/main/PersonalizedEducationAssitant/main.py"
    click CDA "https://github.com/rooban-oss/agentic_ai_workshop/blob/main/codeDebuggingAgent/main.py"

    %% Styles
    classDef frontend fill:#ADD8E6,stroke:#000,stroke-width:1px
    classDef backend fill:#90EE90,stroke:#000,stroke-width:1px
    classDef database fill:#FFA500,stroke:#000,stroke-width:1px
    classDef external fill:#D3D3D3,stroke:#000,stroke-width:1px
```
