# ashrokss/ai-agents architecture

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

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

## Overview

##### Project type and purpose
- This is a Python monorepo of multiple AI agents built on the Agno framework.
- Each subfolder (Deep Research Agent, Finance Agent, Recruitment Agent Team, SQL-Agent) is a standalone “agent” project containing its own entrypoint (`app.py` or `app-st.py`), agent logic, utilities, and dependencies.
- The root README describes the overall goal: to provide a baseline for LLM-powered, tool-enabled multi-agent systems.

##### File structure
- Top-level folders:
- Deep Research Agent/
- Finance Agent/
- Recruitment Agent Team/
- SQL-Agent/
- Common patterns in each agent folder:
- README.md – describes that agent’s use case
- app.py or app-st.py – application entrypoint (API server or Streamlit UI)
- agents.py or finance_agent.py – agent orchestration code
- utils/ – shared helper functions (Recruitment Agent Team)
- config.py (SQL-Agent) – service configs, database credentials, etc.
- requirements.txt – Python dependencies

##### README for additional insights
- Agno provides the core abstractions: AgentManager, Tool integration, LLM client adapters (OpenAI, Azure, Gemini).
- It supports streaming, tool chaining, multi-agent workflows—key architectural capabilities.

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Agno Core and External Services
    AgnoCore["Agno Framework"]:::agno
    subgraph "LLM Providers"
        OpenAI["OpenAI"]:::external
        AzureOpenAI["AzureOpenAI"]:::external
        Gemini["Gemini"]:::external
    end
    SQLDB["SQL Database"]:::external

    %% Agent Suite
    subgraph "Agno-based AI Agent Suite"
        direction TB

        %% Deep Research Agent
        subgraph "Deep Research Agent"
            direction TB
            DRA_UI["app.py (Presentation Layer)"]:::frontend
            DRA_OR["agents.py (Orchestrator)"]:::orchestrator
            DRA_UTILS["utils.py"]:::util
            subgraph "UI Assets"
                direction TB
                DRA_STYLE["style.py"]:::util
                DRA_ANIM["animation.py"]:::util
                DRA_ICONS["icons/"]:::util
            end
        end

        %% Finance Agent
        subgraph "Finance Agent"
            direction TB
            FA_UI["app-st.py (Streamlit UI)"]:::frontend
            FA_OR["finance_agent.py (Orchestrator)"]:::orchestrator
        end

        %% Recruitment Agent Team
        subgraph "Recruitment Agent Team"
            direction TB
            RA_UI["app.py (Presentation Layer)"]:::frontend
            RA_OR["agents.py (Orchestrator)"]:::orchestrator
            subgraph "Utilities"
                direction TB
                RA_UTIL1["batch_processing.py"]:::util
                RA_UTIL2["resume_preview.py"]:::util
                RA_UTIL3["text_extraction.py"]:::util
            end
        end

        %% SQL-Agent
        subgraph "SQL-Agent"
            direction TB
            SQL_UI["app.py (Presentation Layer)"]:::frontend
            SQL_CONF["config.py (Configuration)"]:::util
            SQL_STYLE["style.py (UI Styling)"]:::util
        end
    end

    %% Data Flows
    DRA_UI -->|"calls"| DRA_OR
    FA_UI -->|"invokes"| FA_OR
    RA_UI -->|"requests"| RA_OR
    SQL_UI -->|"initiates"| SQL_CONF
    SQL_CONF -->|"configures"| SQL_DB_OP[Database Ops]:::orchestrator
    SQL_DB_OP -->|"queries"| SQLDB
    SQLDB -->|"returns data"| SQL_DB_OP

    %% Orchestrator to Agno Core
    DRA_OR -->|"uses"| AgnoCore
    FA_OR -->|"uses"| AgnoCore
    RA_OR -->|"uses"| AgnoCore
    SQL_CONF -->|"uses"| AgnoCore

    %% Agno Core to LLM Providers
    AgnoCore -->|"LLM calls"| OpenAI
    AgnoCore -->|"LLM calls"| AzureOpenAI
    AgnoCore -->|"LLM calls"| Gemini

    %% Utilities usage
    DRA_UI -->|"utilizes"| DRA_UTILS
    DRA_OR -->|"utilizes"| DRA_UTILS
    FA_OR -->|"utilizes"| FA_OR_UTILS[Finance Utils]:::util
    RA_OR -->|"utilizes"| RA_UTIL1
    RA_OR -->|"utilizes"| RA_UTIL2
    RA_OR -->|"utilizes"| RA_UTIL3
    SQL_UI -->|"utilizes"| SQL_STYLE

    %% Click Events
    click DRA_UI "https://github.com/ashrokss/ai-agents/blob/main/Deep Research Agent/app.py"
    click DRA_OR "https://github.com/ashrokss/ai-agents/blob/main/Deep Research Agent/agents.py"
    click DRA_STYLE "https://github.com/ashrokss/ai-agents/blob/main/Deep Research Agent/style.py"
    click DRA_ANIM "https://github.com/ashrokss/ai-agents/blob/main/Deep Research Agent/animation.py"
    click DRA_ICONS "https://github.com/ashrokss/ai-agents/tree/main/Deep Research Agent/icons/"
    click DRA_UTILS "https://github.com/ashrokss/ai-agents/blob/main/Deep Research Agent/utils.py"
    click FA_UI "https://github.com/ashrokss/ai-agents/blob/main/Finance Agent/app-st.py"
    click FA_OR "https://github.com/ashrokss/ai-agents/blob/main/Finance Agent/finance_agent.py"
    click RA_UI "https://github.com/ashrokss/ai-agents/blob/main/Recruitment Agent Team/app.py"
    click RA_OR "https://github.com/ashrokss/ai-agents/blob/main/Recruitment Agent Team/agents.py"
    click RA_UTIL1 "https://github.com/ashrokss/ai-agents/blob/main/Recruitment Agent Team/utils/batch_processing.py"
    click RA_UTIL2 "https://github.com/ashrokss/ai-agents/blob/main/Recruitment Agent Team/utils/resume_preview.py"
    click RA_UTIL3 "https://github.com/ashrokss/ai-agents/blob/main/Recruitment Agent Team/utils/text_extraction.py"
    click SQL_UI "https://github.com/ashrokss/ai-agents/blob/main/SQL-Agent/app.py"
    click SQL_CONF "https://github.com/ashrokss/ai-agents/blob/main/SQL-Agent/config.py"
    click SQL_STYLE "https://github.com/ashrokss/ai-agents/blob/main/SQL-Agent/style.py"

    %% Styles
    classDef frontend fill:#cce5ff,stroke:#0066cc,stroke-width:1px
    classDef orchestrator fill:#d4edda,stroke:#2e7d32,stroke-width:1px
    classDef util fill:#f0f0f0,stroke:#666666,stroke-width:1px
    classDef agno fill:#ffe5b4,stroke:#ff8c00,stroke-width:1px
    classDef external fill:#e0bbE4,stroke:#6a1b9a,stroke-width:1px
```
