# omashish/google-adk-workflows architecture

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

- Interactive diagram: https://gitdiagram.com/omashish/google-adk-workflows
- Repository: https://github.com/omashish/google-adk-workflows

## Overview

##### Project type and purpose
- This is a Python-based multi-agent trip planning system built on Google’s Agent Development Kit (ADK).
- Purpose: demonstrate how specialized AI agents (flight, hotel, sightseeing, summary) can be orchestrated by different workflow patterns (simple, dispatcher, parallel, self-critic) to solve complex travel planning tasks.

##### File structure
├── .gitignore
├── README.md
├── env.example        ← environment template
├── requirements.txt   ← dependency list
├── subagent.py        ← “core agents” module (FlightAgent, HotelAgent, SightseeingAgent, TripSummaryAgent)
├── simple/agent.py    ← SimpleAgent orchestration
├── dispatcher/agent.py← DispatcherAgent orchestration
├── parallel/agent.py  ← ParallelAgent orchestration
├── self_critic/agent.py← SelfCriticAgent orchestration
└── (no tests directory, no microservices – all runs in a single ADK process, using modular code)

##### README for additional insights
- Lists four orchestration agents, four core agents, workflow patterns: sequential, parallel, feedback loops, state management.
- Mentions external dependency on Google API Key and Gemini model via ADK.
- Indicates a web interface is launched via `adk web`.

## Diagram (Mermaid)

```mermaid
graph TB
    %% Entities
    User["User / Client"]:::external
    Web["Web Interface (adk web)"]:::interface

    %% Orchestration Agents
    subgraph "Orchestration Agents"
        direction TB
        SA["SimpleAgent"]:::orchestrator
        DA["DispatcherAgent"]:::orchestrator
        PA["ParallelAgent"]:::orchestrator
        SCA["SelfCriticAgent"]:::orchestrator
    end

    %% Core Agents
    subgraph "Core Agents"
        direction TB
        FA["FlightAgent"]:::core
        HA["HotelAgent"]:::core
        CA["SightseeingAgent"]:::core
        TA["TripSummaryAgent"]:::core
        Reviewer["Reviewer/Validator"]:::validator
    end

    %% State and External
    Session[(Session Store)]:::store
    Cloud(("Google Gemini API")):::cloud

    %% Flow Connections
    User -->|requests trip| Web
    Web --> SA
    Web --> DA
    Web --> PA
    Web --> SCA

    %% SimpleAgent Sequential Workflow
    SA --> FA
    FA --> HA
    HA --> CA
    CA --> TA
    TA --> Web

    %% DispatcherAgent Routing Workflow
    DA -->|routes to relevant core| FA
    DA --> HA
    DA --> CA
    DA --> TA
    TA --> Web

    %% ParallelAgent Parallel Workflow
    PA -->|⫸ parallel ⫷| FA
    PA -->|⫸ parallel ⫷| HA
    FA --> TA
    HA --> TA
    TA --> Web

    %% SelfCriticAgent Feedback Workflow
    SCA -->|⫸ parallel ⫷| FA
    SCA -->|⫸ parallel ⫷| HA
    FA --> TA
    HA --> TA
    TA --> Reviewer
    Reviewer --> TA
    TA --> Web

    %% Core to Session and External API
    FA --> Session
    HA --> Session
    CA --> Session
    TA --> Session

    FA --> Cloud
    HA --> Cloud
    CA --> Cloud
    TA --> Cloud
    Reviewer --> Cloud

    %% Click Events
    click SA "https://github.com/omashish/google-adk-workflows/blob/main/simple/agent.py"
    click DA "https://github.com/omashish/google-adk-workflows/blob/main/dispatcher/agent.py"
    click PA "https://github.com/omashish/google-adk-workflows/blob/main/parallel/agent.py"
    click SCA "https://github.com/omashish/google-adk-workflows/blob/main/self_critic/agent.py"
    click FA "https://github.com/omashish/google-adk-workflows/blob/main/subagent.py"
    click Session "https://github.com/omashish/google-adk-workflows/blob/main/env.example"
    click Cloud "https://github.com/omashish/google-adk-workflows/blob/main/requirements.txt"
    click Web "https://github.com/omashish/google-adk-workflows/blob/main/README.md"
    click .gitignore "https://github.com/omashish/google-adk-workflows/blob/main/.gitignore"

    %% Styles
    classDef external fill:#eef,stroke:#669,stroke-width:1px;
    classDef interface fill:#def,stroke:#369,stroke-width:1px;
    classDef orchestrator fill:#f9f,stroke:#936,stroke-width:2px;
    classDef core fill:#ff9,stroke:#963,stroke-width:1px,stroke-dasharray: 5 5;
    classDef store fill:#9ff,stroke:#396,stroke-width:2px,shape:cylinder;
    classDef cloud fill:#cfc,stroke:#383,stroke-width:2px,shape:cloud;
    classDef validator fill:#fc9,stroke:#c63,stroke-width:1px,stroke-dasharray: 2 2;
```
