# prasanna00019/ai-agents-hub architecture

> Architecture diagram of the GitHub repository prasanna00019/ai-agents-hub, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-07-12). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/prasanna00019/ai-agents-hub
- Repository: https://github.com/prasanna00019/ai-agents-hub

## Overview

##### Project type and purpose
- This is a mono-repo (“AI-Agents-Hub”) containing three autonomous LLM-based AI agent prototypes, each built on top of LangChain and auxiliary Python tooling.
- Each sub-folder (Travel_Planner_Agent, Spiritual_AI_Agent, StudyForge-Multi-Agent) represents a distinct agent: a travel planner, a spiritual assistant, and a multi-agent academic study guide generator.

##### File structure
Top-level
- LICENSE, README.md – repo metadata.
- Three subdirectories, one per agent.
Travel_Planner_Agent
- README.md, Travel_Agent_Langchain.ipynb – notebook driving LangChain pipeline for trip planning.
Spiritual_AI_Agent
- README.md, Spiritual_AI_Agent_Langchain.ipynb – notebook for an empathetic/spiritual advice pipeline.
StudyForge-Multi-Agent
- README.md, StudyForge-Multi-AI-Agent.ipynb – notebook for multi-agent orchestration.
- requirements.txt – Python dependencies.
- streamlit.py, streamlit_2.py – two versions of a Streamlit UI.
- Machine_Learning.pdf, Software_Project_Management.pdf – sample inputs.
- final_output.md – sample generated output.

##### README for additional insights
- The top-level README calls out: tool-using agents, memory, decision logic, external data retrieval.
- Technologies in use: LangChain, LangGraph (if any), Jupyter, Streamlit, PDF parsing, web-search and API wrappers (weather, maps, YouTube, image search).

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% UI Layer
    subgraph "UI Layer" 
        direction TB
        Notebook_TP["Travel Planner Notebook"]:::ui
        Notebook_SA["Spiritual AI Notebook"]:::ui
        Streamlit1["Streamlit UI v1"]:::ui
        Streamlit2["Streamlit UI v2"]:::ui
    end

    %% Orchestration Layer
    subgraph "Orchestration Layer"
        direction TB
        Core_TP["LangChain Core (Travel)"]:::orchestration
        Core_SA["LangChain Core (Spiritual)"]:::orchestration
        Orchestrator_SF["Multi-Agent Orchestrator"]:::orchestration
        SA_Summarizer["Summarizer Agent"]:::orchestration
        SA_MCQ["MCQ Generator Agent"]:::orchestration
        SA_QA["Q&A Agent"]:::orchestration
    end

    %% Tools & External Services
    subgraph "Tools & External Services"
        direction TB
        WeatherAPI["Weather API"]:::tools
        MapsAPI["Maps & Hotels API"]:::tools
        PDFParser["PDF Parser"]:::tools
        ImageSearch["Image Search API"]:::tools
        YouTubeAPI["YouTube API"]:::tools
    end

    %% Data / Memory Stores
    subgraph "Data & Memory Stores"
        direction TB
        VectorDB["Vector DB (embeddings)"]:::datastore
        InMemory["In-Memory Cache"]:::datastore
    end

    %% Outputs
    subgraph "Generated Outputs"
        direction TB
        Itinerary["Trip Itinerary"]:::outputs
        Guidance["Spiritual Guidance"]:::outputs
        StudyOutputs["Study Guide Assets"]:::outputs
    end

    %% Connections UI to Orchestration
    Notebook_TP -->|"LLM prompt → JSON reply"| Core_TP
    Notebook_SA -->|"LLM prompt → JSON reply"| Core_SA
    Streamlit1 -->|"User request JSON"| Orchestrator_SF
    Streamlit2 -->|"User request JSON"| Orchestrator_SF

    %% Orchestration to Sub-Agents
    Orchestrator_SF -->|"delegate tasks"| SA_Summarizer
    Orchestrator_SF -->|"delegate tasks"| SA_MCQ
    Orchestrator_SF -->|"delegate tasks"| SA_QA
    SA_Summarizer -->|"summary JSON"| Orchestrator_SF
    SA_MCQ -->|"MCQs JSON"| Orchestrator_SF
    SA_QA -->|"answers JSON"| Orchestrator_SF

    %% Orchestration to Tools
    Core_TP -->|"REST API call JSON"| WeatherAPI
    Core_TP -->|"REST API call JSON"| MapsAPI
    Core_SA -->|"knowledge lookup"| PDFParser
    Orchestrator_SF -->|"PDF → text"| PDFParser
    Orchestrator_SF -->|"search request"| ImageSearch
    Orchestrator_SF -->|"video request"| YouTubeAPI

    %% Orchestration to Data Stores
    Core_TP -->|"store/retrieve embeddings"| VectorDB
    Core_SA -->|"store session history"| InMemory
    Orchestrator_SF -->|"store PDF embeddings"| VectorDB
    Orchestrator_SF -->|"session cache"| InMemory

    %% Orchestration back to UI
    Core_TP -->|"itinerary JSON"| Notebook_TP
    Core_SA -->|"guidance JSON"| Notebook_SA
    Orchestrator_SF -->|"assets JSON"| Streamlit1
    Orchestrator_SF -->|"assets JSON"| Streamlit2

    %% UI to Outputs
    Notebook_TP --> Itinerary
    Notebook_SA --> Guidance
    Streamlit1 --> StudyOutputs
    Streamlit2 --> StudyOutputs

    %% Click Events
    click Notebook_TP "https://github.com/prasanna00019/ai-agents-hub/blob/main/Travel_Planner_Agent/Travel_Agent_Langchain.ipynb"
    click Notebook_SA "https://github.com/prasanna00019/ai-agents-hub/blob/main/Spiritual_AI_Agent/Spiritual_AI_Agent_Langchain.ipynb"
    click Streamlit1 "https://github.com/prasanna00019/ai-agents-hub/blob/main/StudyForge-Multi-Agent/streamlit.py"
    click Streamlit2 "https://github.com/prasanna00019/ai-agents-hub/blob/main/StudyForge-Multi-Agent/streamlit_2.py"
    click Orchestrator_SF "https://github.com/prasanna00019/ai-agents-hub/blob/main/StudyForge-Multi-Agent/StudyForge-Multi-AI-Agent.ipynb"
    click VectorDB "https://github.com/prasanna00019/ai-agents-hub/blob/main/StudyForge-Multi-Agent/requirements.txt"
    click PDFParser "https://github.com/prasanna00019/ai-agents-hub/blob/main/StudyForge-Multi-Agent/Machine_Learning.pdf"
    click PDFParser "https://github.com/prasanna00019/ai-agents-hub/blob/main/StudyForge-Multi-Agent/Software_Project_Management.pdf"
    click StudyOutputs "https://github.com/prasanna00019/ai-agents-hub/blob/main/StudyForge-Multi-Agent/final_output.md"
    click Travel_Planner_Agent_Dir "https://github.com/prasanna00019/ai-agents-hub/tree/main/Travel_Planner_Agent/"
    click Spiritual_AI_Agent_Dir "https://github.com/prasanna00019/ai-agents-hub/tree/main/Spiritual_AI_Agent/"
    click StudyForge_Dir "https://github.com/prasanna00019/ai-agents-hub/tree/main/StudyForge-Multi-Agent/"
    click RepoReadme "https://github.com/prasanna00019/ai-agents-hub/blob/main/README.md"
    click RepoLicense "https://github.com/prasanna00019/ai-agents-hub/tree/main/LICENSE"

    %% Styles
    classDef ui fill:#D0E6FF,stroke:#333,stroke-width:1px
    classDef orchestration fill:#DFFFD0,stroke:#333,stroke-width:1px
    classDef tools fill:#FFE4B5,stroke:#333,stroke-width:1px
    classDef datastore fill:#E6E6FA,stroke:#333,stroke-width:1px
    classDef outputs fill:#FFF5CC,stroke:#333,stroke-width:1px
```
