# eeman1113/a2a_experiments architecture

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

- Interactive diagram: https://gitdiagram.com/eeman1113/a2a_experiments
- Repository: https://github.com/eeman1113/a2a_experiments

## Overview

##### Project type and purpose
- This is a small “AI‐conversation” tool: a script-based experiment where two AI agents talk to each other.
- The README says “just 2 ai talking” and the file tree shows a main script (`main.py`), JSON logs, and a Jupyter notebook for analysis.

##### File structure
- Top-level:
- `.gitignore`, `LICENSE` – repository metadata
- `main.py` – orchestration entry point
- `Multi_Agent_Conversation_(A2A_Concepts).ipynb` – exploratory notebook
- `ai_collaboration_*.json` – sequential logs of agent conversations
- No separate “frontend” or “backend” directories—this is a single-process command-line tool.

##### README for additional insights
- No detailed architecture section—focus is on two AI agents exchanging messages.
- The notebook likely contains experiment code and visualizations.

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Orchestration Layer
    O["Orchestrator"]:::orchestration
    click O "https://github.com/eeman1113/a2a_experiments/blob/main/main.py"

    %% Agent Modules
    subgraph "Agent Modules"
        A1["Agent A Wrapper"]:::inference
        A2["Agent B Wrapper"]:::inference
    end
    click A1 "https://github.com/eeman1113/a2a_experiments/blob/main/main.py"
    click A2 "https://github.com/eeman1113/a2a_experiments/blob/main/main.py"

    %% External AI Service
    E["External AI Service"]:::inference
    click E "https://github.com/eeman1113/a2a_experiments/blob/main/main.py"

    %% Storage / Logging
    subgraph "Logger / Storage"
        L1["ai_collaboration_20250424-185539.json"]:::storage
        L2["ai_collaboration_20250424-185927.json"]:::storage
        L3["ai_collaboration_20250424-190215.json"]:::storage
        L4["ai_collaboration_20250424-190513.json"]:::storage
        L5["ai_collaboration_20250424-193001.json"]:::storage
    end

    %% Analysis
    N["Analysis Notebook"]:::storage
    click N "https://github.com/eeman1113/a2a_experiments/blob/main/Multi_Agent_Conversation_(A2A_Concepts).ipynb"

    %% Data Flows
    O -->|"prompt to A"| A1
    A1 -->|"API request"| E
    E -->|"response"| A1
    A1 -->|"response"| O

    O -->|"prompt to B"| A2
    A2 -->|"API request"| E
    E -->|"response"| A2
    A2 -->|"response"| O

    O -->|"JSON record"| L1
    O -->|"JSON record"| L2
    O -->|"JSON record"| L3
    O -->|"JSON record"| L4
    O -->|"JSON record"| L5

    N -->|"reads logs"| L1
    N -->|"reads logs"| L2
    N -->|"reads logs"| L3
    N -->|"reads logs"| L4
    N -->|"reads logs"| L5

    %% Styles
    classDef orchestration fill:#ADD8E6,stroke:#000,stroke-width:1px;
    classDef inference fill:#90EE90,stroke:#000,stroke-width:1px;
    classDef storage fill:#FFA500,stroke:#000,stroke-width:1px;
```
