# ed-donner/agents architecture

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

- Interactive diagram: https://gitdiagram.com/ed-donner/agents
- Repository: https://github.com/ed-donner/agents

## Overview

This repository is a six-week learning course for building and deploying autonomous AI agents, not a single agent application. The principal user workflow is a learner progressing through examples of agent fundamentals, orchestration frameworks, and MCP; the README names OpenAI Agents SDK, CrewAI, LangGraph, Google ADK, Pydantic AI, and MCP. The graph highlights those curriculum branches and a sampled Gradio digital-twin example as one concrete internal workflow. The tree and excerpts show many independent community projects, so their runtime relationships should not be read as one integrated system.

Main entry points: [`2_openai/deep_research/research_manager.py`](https://github.com/ed-donner/agents/blob/main/2_openai/deep_research/research_manager.py) (Research manager), [`1_foundations/community_contributions/haastrupea/src/pipeline.py`](https://github.com/ed-donner/agents/blob/main/1_foundations/community_contributions/haastrupea/src/pipeline.py) (Chat pipeline), [`1_foundations/community_contributions/haastrupea/src/tools.py`](https://github.com/ed-donner/agents/blob/main/1_foundations/community_contributions/haastrupea/src/tools.py) (Agent tools), [`1_foundations/community_contributions/haastrupea/app/gradio.py`](https://github.com/ed-donner/agents/blob/main/1_foundations/community_contributions/haastrupea/app/gradio.py) (Digital twin UI)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_foundations["Agent foundations"]
  node_foundations_examples["Foundations examples"]
  node_twin_ui["Digital twin UI<br/>[gradio.py]"]
  node_twin_pipeline["Chat pipeline<br/>[pipeline.py]"]
  node_twin_agent["Chat agent<br/>[agent.py]"]
  node_twin_tools["Agent tools<br/>[tools.py]"]
  node_twin_rag["RAG retrieval<br/>[rag_system.py]"]
  node_pushover["Push notifications<br/>[Pushover.py]"]
end

subgraph group_openai["OpenAI agents"]
  node_openai_examples["OpenAI examples"]
  node_research_manager["Research manager"]
  node_research_planner["Research planner<br/>[planner_agent.py]"]
  node_research_search["Web search agent<br/>[search_agent.py]"]
  node_research_writer["Report writer<br/>[writer_agent.py]"]
  node_research_email["Email agent<br/>[email_agent.py]"]
end

subgraph group_crewai["CrewAI"]
  node_crewai_examples["CrewAI examples"]
end

subgraph group_langgraph["LangGraph"]
  node_langgraph_examples["LangGraph examples"]
end

subgraph group_frameworks["Agent frameworks"]
  node_framework_examples["Framework examples"]
  node_agent_loop_config["Agent loop models<br/>[config.py]"]
end

subgraph group_mcp["MCP"]
  node_mcp_examples["MCP examples"]
  node_trading_engine["Trading engine<br/>[engine.py]"]
  node_date_client["Date tool client"]
end

node_learner(("Learner"))

node_learner -->|"explores"| node_foundations_examples
node_learner -->|"explores"| node_openai_examples
node_learner -->|"explores"| node_crewai_examples
node_learner -->|"explores"| node_langgraph_examples
node_learner -->|"explores"| node_framework_examples
node_learner -->|"explores"| node_mcp_examples
node_twin_ui -->|"calls"| node_twin_pipeline
node_twin_pipeline -->|"calls"| node_twin_agent
node_twin_pipeline -->|"retrieves from"| node_twin_rag
node_twin_pipeline -->|"provides to"| node_twin_tools
node_twin_tools -->|"uses"| node_pushover
node_research_manager -->|"runs"| node_research_planner
node_research_manager -->|"runs"| node_research_search
node_research_manager -->|"runs"| node_research_writer
node_research_manager -->|"runs"| node_research_email

click node_foundations_examples "https://github.com/ed-donner/agents/tree/main/1_foundations/community_contributions"
click node_twin_ui "https://github.com/ed-donner/agents/blob/main/1_foundations/community_contributions/haastrupea/app/gradio.py"
click node_twin_pipeline "https://github.com/ed-donner/agents/blob/main/1_foundations/community_contributions/haastrupea/src/pipeline.py"
click node_twin_agent "https://github.com/ed-donner/agents/blob/main/1_foundations/community_contributions/haastrupea/src/agent.py"
click node_twin_tools "https://github.com/ed-donner/agents/blob/main/1_foundations/community_contributions/haastrupea/src/tools.py"
click node_twin_rag "https://github.com/ed-donner/agents/blob/main/1_foundations/community_contributions/haastrupea/src/rag_system.py"
click node_pushover "https://github.com/ed-donner/agents/blob/main/1_foundations/community_contributions/haastrupea/ultils/Pushover.py"
click node_openai_examples "https://github.com/ed-donner/agents/tree/main/2_openai/community_contributions"
click node_research_manager "https://github.com/ed-donner/agents/blob/main/2_openai/deep_research/research_manager.py"
click node_research_planner "https://github.com/ed-donner/agents/blob/main/2_openai/deep_research/planner_agent.py"
click node_research_search "https://github.com/ed-donner/agents/blob/main/2_openai/deep_research/search_agent.py"
click node_research_writer "https://github.com/ed-donner/agents/blob/main/2_openai/deep_research/writer_agent.py"
click node_research_email "https://github.com/ed-donner/agents/blob/main/2_openai/deep_research/email_agent.py"
click node_crewai_examples "https://github.com/ed-donner/agents/tree/main/3_crewai/community_contributions"
click node_langgraph_examples "https://github.com/ed-donner/agents/tree/main/4_langchain_langgraph/community_contributions"
click node_framework_examples "https://github.com/ed-donner/agents/tree/main/5_agent_frameworks/community_contributions"
click node_agent_loop_config "https://github.com/ed-donner/agents/blob/main/5_agent_frameworks/5_agent_loop/config.py"
click node_mcp_examples "https://github.com/ed-donner/agents/tree/main/6_mcp/community_contributions"
click node_trading_engine "https://github.com/ed-donner/agents/blob/main/6_mcp/community_contributions/frex-multi-agent-auto-trader/engine.py"
click node_date_client "https://github.com/ed-donner/agents/blob/main/6_mcp/community_contributions/simple_mcp_date_server/simple_client_llm.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_foundations_examples,node_twin_ui,node_twin_pipeline,node_twin_agent,node_twin_tools,node_twin_rag,node_pushover toneBlue
class node_openai_examples,node_research_manager,node_research_planner,node_research_search,node_research_writer,node_research_email toneAmber
class node_crewai_examples toneMint
class node_langgraph_examples toneRose
class node_framework_examples,node_agent_loop_config,node_learner toneIndigo
class node_mcp_examples,node_trading_engine,node_date_client toneTeal
```

## Components

### Agent foundations

- [Foundations examples](https://github.com/ed-donner/agents/tree/main/1_foundations/community_contributions): `1_foundations/community_contributions`
- [Digital twin UI](https://github.com/ed-donner/agents/blob/main/1_foundations/community_contributions/haastrupea/app/gradio.py): `1_foundations/community_contributions/haastrupea/app/gradio.py`
- [Chat pipeline](https://github.com/ed-donner/agents/blob/main/1_foundations/community_contributions/haastrupea/src/pipeline.py): `1_foundations/community_contributions/haastrupea/src/pipeline.py`
- [Chat agent](https://github.com/ed-donner/agents/blob/main/1_foundations/community_contributions/haastrupea/src/agent.py): `1_foundations/community_contributions/haastrupea/src/agent.py`
- [Agent tools](https://github.com/ed-donner/agents/blob/main/1_foundations/community_contributions/haastrupea/src/tools.py): `1_foundations/community_contributions/haastrupea/src/tools.py`
- [RAG retrieval](https://github.com/ed-donner/agents/blob/main/1_foundations/community_contributions/haastrupea/src/rag_system.py): `1_foundations/community_contributions/haastrupea/src/rag_system.py`
- [Push notifications](https://github.com/ed-donner/agents/blob/main/1_foundations/community_contributions/haastrupea/ultils/Pushover.py): `1_foundations/community_contributions/haastrupea/ultils/Pushover.py`

### OpenAI agents

- [OpenAI examples](https://github.com/ed-donner/agents/tree/main/2_openai/community_contributions): `2_openai/community_contributions`
- [Research manager](https://github.com/ed-donner/agents/blob/main/2_openai/deep_research/research_manager.py): `2_openai/deep_research/research_manager.py`
- [Research planner](https://github.com/ed-donner/agents/blob/main/2_openai/deep_research/planner_agent.py): `2_openai/deep_research/planner_agent.py`
- [Web search agent](https://github.com/ed-donner/agents/blob/main/2_openai/deep_research/search_agent.py): `2_openai/deep_research/search_agent.py`
- [Report writer](https://github.com/ed-donner/agents/blob/main/2_openai/deep_research/writer_agent.py): `2_openai/deep_research/writer_agent.py`
- [Email agent](https://github.com/ed-donner/agents/blob/main/2_openai/deep_research/email_agent.py): `2_openai/deep_research/email_agent.py`

### CrewAI

- [CrewAI examples](https://github.com/ed-donner/agents/tree/main/3_crewai/community_contributions): `3_crewai/community_contributions`

### LangGraph

- [LangGraph examples](https://github.com/ed-donner/agents/tree/main/4_langchain_langgraph/community_contributions): `4_langchain_langgraph/community_contributions`

### Agent frameworks

- [Framework examples](https://github.com/ed-donner/agents/tree/main/5_agent_frameworks/community_contributions): `5_agent_frameworks/community_contributions`
- [Agent loop models](https://github.com/ed-donner/agents/blob/main/5_agent_frameworks/5_agent_loop/config.py): `5_agent_frameworks/5_agent_loop/config.py`

### MCP

- [MCP examples](https://github.com/ed-donner/agents/tree/main/6_mcp/community_contributions): `6_mcp/community_contributions`
- [Trading engine](https://github.com/ed-donner/agents/blob/main/6_mcp/community_contributions/frex-multi-agent-auto-trader/engine.py): `6_mcp/community_contributions/frex-multi-agent-auto-trader/engine.py`
- [Date tool client](https://github.com/ed-donner/agents/blob/main/6_mcp/community_contributions/simple_mcp_date_server/simple_client_llm.py): `6_mcp/community_contributions/simple_mcp_date_server/simple_client_llm.py`

### Other components

- **Learner**

## Connections

- Learner → Foundations examples: explores (evidence: `README.md`)
- Learner → OpenAI examples: explores (evidence: `README.md`)
- Learner → CrewAI examples: explores (evidence: `README.md`)
- Learner → LangGraph examples: explores (evidence: `README.md`)
- Learner → Framework examples: explores (evidence: `README.md`)
- Learner → MCP examples: explores (evidence: `README.md`)
- Digital twin UI → Chat pipeline: calls (evidence: `1_foundations/community_contributions/haastrupea/app/gradio.py`)
- Chat pipeline → Chat agent: calls (evidence: `1_foundations/community_contributions/haastrupea/src/pipeline.py`)
- Chat pipeline → RAG retrieval: retrieves from (evidence: `1_foundations/community_contributions/haastrupea/src/pipeline.py`)
- Chat pipeline → Agent tools: provides to (evidence: `1_foundations/community_contributions/haastrupea/src/pipeline.py`)
- Agent tools → Push notifications: uses (evidence: `1_foundations/community_contributions/haastrupea/src/tools.py`)
- Research manager → Research planner: runs (evidence: `2_openai/deep_research/research_manager.py`)
- Research manager → Web search agent: runs (evidence: `2_openai/deep_research/research_manager.py`)
- Research manager → Report writer: runs (evidence: `2_openai/deep_research/research_manager.py`)
- Research manager → Email agent: runs (evidence: `2_openai/deep_research/research_manager.py`)
