# ckdvs99/autogen architecture

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

- Interactive diagram: https://gitdiagram.com/ckdvs99/autogen
- Repository: https://github.com/ckdvs99/autogen

## Overview

AutoGen is a multi-agent AI framework and tooling ecosystem spanning Python and .NET. A typical user task enters an AgentChat assistant or team, is handled through Core runtime/message abstractions and a model-client extension, and returns a task result; tools can extend that interaction. Major separate capabilities include multi-agent orchestration, distributed runtimes, AutoGen Studio, and benchmarking. The README documents the Python layering and capabilities; the graph keeps less-explicit implementation links dashed or omits them where the supplied excerpts do not establish a call.

Main entry points: [`python/packages/autogen-agentchat/src/autogen_agentchat/agents/_assistant_agent.py`](https://github.com/ckdvs99/autogen/blob/main/python/packages/autogen-agentchat/src/autogen_agentchat/agents/_assistant_agent.py) (Assistant agent), [`python/packages/autogen-agentchat/src/autogen_agentchat/teams/_group_chat`](https://github.com/ckdvs99/autogen/tree/main/python/packages/autogen-agentchat/src/autogen_agentchat/teams/_group_chat) (Agent teams), [`python/packages/autogen-core/src/autogen_core/_single_threaded_agent_runtime.py`](https://github.com/ckdvs99/autogen/blob/main/python/packages/autogen-core/src/autogen_core/_single_threaded_agent_runtime.py) (Agent runtime), [`python/packages/autogen-studio/autogenstudio/web/app.py`](https://github.com/ckdvs99/autogen/blob/main/python/packages/autogen-studio/autogenstudio/web/app.py) (Studio service)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_agentchat["AgentChat workflows"]
  node_assistant["Assistant agent"]
  node_team["Agent teams"]
  node_chat_messages["Chat messages<br/>[messages.py]"]
  node_task_result["Task result<br/>[_task.py]"]
  node_dotnet_agentchat[".NET AgentChat"]
end

subgraph group_core["Core runtime"]
  node_core_messages["Core messages"]
  node_routed_agents["Routed agents<br/>[_routed_agent.py]"]
  node_agent_identity["Agent identity<br/>[_agent_id.py]"]
  node_runtime["Agent runtime"]
  node_model_client["Model client API<br/>[_model_client.py]"]
  node_dotnet_core[".NET Core API<br/>[GroupChat.cs]"]
end

subgraph group_extensions["Model and tool extensions"]
  node_model_providers["Model providers"]
  node_web_surfer["Web browsing"]
  node_mcp["MCP workbench"]
  node_dotnet_providers[".NET model clients<br/>[AnthropicClient.cs]"]
end

subgraph group_studio["Studio application"]
  node_studio_ui["Studio UI<br/>[manager.tsx]"]
  node_studio_api["Studio service<br/>[app.py]"]
  node_team_manager["Team manager<br/>[teammanager.py]"]
  node_studio_database[("Studio database<br/>[db_manager.py]")]
end

subgraph group_devtools["Developer tools"]
  node_benchmark["Benchmark suite<br/>[run_cmd.py]"]
end

node_user(("User"))

node_user -->|"submits task"| node_assistant
node_assistant -->|"requests completion"| node_model_client
node_model_client -->|"implemented by"| node_model_providers
node_assistant -.->|"uses messages"| node_chat_messages
node_team -->|"coordinates agents"| node_assistant
node_team -.->|"returns result"| node_task_result
node_routed_agents -.->|"runs within"| node_runtime
node_runtime -.->|"routes by identity"| node_agent_identity
node_runtime -.->|"passes messages"| node_core_messages
node_assistant -->|"built on Core"| node_core_messages
node_assistant -->|"can use browsing"| node_web_surfer
node_assistant -->|"can use workbench"| node_mcp
node_studio_ui -.->|"uses service"| node_studio_api
node_studio_api -.->|"runs teams"| node_team_manager
node_team_manager -.->|"creates teams"| node_team
node_studio_api -.->|"persists data"| node_studio_database
node_benchmark -.->|"evaluates agents"| node_team
node_dotnet_agentchat -->|"built on Core"| node_dotnet_core
node_dotnet_providers -.->|"extends framework"| node_dotnet_core

click node_assistant "https://github.com/ckdvs99/autogen/blob/main/python/packages/autogen-agentchat/src/autogen_agentchat/agents/_assistant_agent.py"
click node_team "https://github.com/ckdvs99/autogen/tree/main/python/packages/autogen-agentchat/src/autogen_agentchat/teams/_group_chat"
click node_chat_messages "https://github.com/ckdvs99/autogen/blob/main/python/packages/autogen-agentchat/src/autogen_agentchat/messages.py"
click node_task_result "https://github.com/ckdvs99/autogen/blob/main/python/packages/autogen-agentchat/src/autogen_agentchat/base/_task.py"
click node_core_messages "https://github.com/ckdvs99/autogen/blob/main/python/packages/autogen-core/src/autogen_core/_message_handler_context.py"
click node_routed_agents "https://github.com/ckdvs99/autogen/blob/main/python/packages/autogen-core/src/autogen_core/_routed_agent.py"
click node_agent_identity "https://github.com/ckdvs99/autogen/blob/main/python/packages/autogen-core/src/autogen_core/_agent_id.py"
click node_runtime "https://github.com/ckdvs99/autogen/blob/main/python/packages/autogen-core/src/autogen_core/_single_threaded_agent_runtime.py"
click node_model_client "https://github.com/ckdvs99/autogen/blob/main/python/packages/autogen-core/src/autogen_core/models/_model_client.py"
click node_model_providers "https://github.com/ckdvs99/autogen/tree/main/python/packages/autogen-ext/src/autogen_ext/models"
click node_web_surfer "https://github.com/ckdvs99/autogen/blob/main/python/packages/autogen-ext/src/autogen_ext/agents/web_surfer/playwright_controller.py"
click node_mcp "https://github.com/ckdvs99/autogen/tree/main/python/packages/autogen-ext/src/autogen_ext/tools/mcp"
click node_studio_ui "https://github.com/ckdvs99/autogen/blob/main/python/packages/autogen-studio/frontend/src/components/views/playground/manager.tsx"
click node_studio_api "https://github.com/ckdvs99/autogen/blob/main/python/packages/autogen-studio/autogenstudio/web/app.py"
click node_team_manager "https://github.com/ckdvs99/autogen/blob/main/python/packages/autogen-studio/autogenstudio/teammanager/teammanager.py"
click node_studio_database "https://github.com/ckdvs99/autogen/blob/main/python/packages/autogen-studio/autogenstudio/database/db_manager.py"
click node_benchmark "https://github.com/ckdvs99/autogen/blob/main/python/packages/agbench/src/agbench/run_cmd.py"
click node_dotnet_core "https://github.com/ckdvs99/autogen/blob/main/dotnet/src/AutoGen.Core/GroupChat/GroupChat.cs"
click node_dotnet_agentchat "https://github.com/ckdvs99/autogen/blob/main/dotnet/src/Microsoft.AutoGen/AgentChat/GroupChat/GroupChatManagerBase.cs"
click node_dotnet_providers "https://github.com/ckdvs99/autogen/blob/main/dotnet/src/AutoGen.Anthropic/AnthropicClient.cs"

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_assistant,node_team,node_chat_messages,node_task_result,node_dotnet_agentchat,node_user toneBlue
class node_core_messages,node_routed_agents,node_agent_identity,node_runtime,node_model_client,node_dotnet_core toneAmber
class node_model_providers,node_web_surfer,node_mcp,node_dotnet_providers toneMint
class node_studio_ui,node_studio_api,node_team_manager,node_studio_database toneRose
class node_benchmark toneIndigo
```

## Components

### AgentChat workflows

- [Assistant agent](https://github.com/ckdvs99/autogen/blob/main/python/packages/autogen-agentchat/src/autogen_agentchat/agents/_assistant_agent.py): `python/packages/autogen-agentchat/src/autogen_agentchat/agents/_assistant_agent.py`
- [Agent teams](https://github.com/ckdvs99/autogen/tree/main/python/packages/autogen-agentchat/src/autogen_agentchat/teams/_group_chat): `python/packages/autogen-agentchat/src/autogen_agentchat/teams/_group_chat`
- [Chat messages](https://github.com/ckdvs99/autogen/blob/main/python/packages/autogen-agentchat/src/autogen_agentchat/messages.py): `python/packages/autogen-agentchat/src/autogen_agentchat/messages.py`
- [Task result](https://github.com/ckdvs99/autogen/blob/main/python/packages/autogen-agentchat/src/autogen_agentchat/base/_task.py): `python/packages/autogen-agentchat/src/autogen_agentchat/base/_task.py`
- [.NET AgentChat](https://github.com/ckdvs99/autogen/blob/main/dotnet/src/Microsoft.AutoGen/AgentChat/GroupChat/GroupChatManagerBase.cs): `dotnet/src/Microsoft.AutoGen/AgentChat/GroupChat/GroupChatManagerBase.cs`

### Core runtime

- [Core messages](https://github.com/ckdvs99/autogen/blob/main/python/packages/autogen-core/src/autogen_core/_message_handler_context.py): `python/packages/autogen-core/src/autogen_core/_message_handler_context.py`
- [Routed agents](https://github.com/ckdvs99/autogen/blob/main/python/packages/autogen-core/src/autogen_core/_routed_agent.py): `python/packages/autogen-core/src/autogen_core/_routed_agent.py`
- [Agent identity](https://github.com/ckdvs99/autogen/blob/main/python/packages/autogen-core/src/autogen_core/_agent_id.py): `python/packages/autogen-core/src/autogen_core/_agent_id.py`
- [Agent runtime](https://github.com/ckdvs99/autogen/blob/main/python/packages/autogen-core/src/autogen_core/_single_threaded_agent_runtime.py): `python/packages/autogen-core/src/autogen_core/_single_threaded_agent_runtime.py`
- [Model client API](https://github.com/ckdvs99/autogen/blob/main/python/packages/autogen-core/src/autogen_core/models/_model_client.py): `python/packages/autogen-core/src/autogen_core/models/_model_client.py`
- [.NET Core API](https://github.com/ckdvs99/autogen/blob/main/dotnet/src/AutoGen.Core/GroupChat/GroupChat.cs): `dotnet/src/AutoGen.Core/GroupChat/GroupChat.cs`

### Model and tool extensions

- [Model providers](https://github.com/ckdvs99/autogen/tree/main/python/packages/autogen-ext/src/autogen_ext/models): `python/packages/autogen-ext/src/autogen_ext/models`
- [Web browsing](https://github.com/ckdvs99/autogen/blob/main/python/packages/autogen-ext/src/autogen_ext/agents/web_surfer/playwright_controller.py): `python/packages/autogen-ext/src/autogen_ext/agents/web_surfer/playwright_controller.py`
- [MCP workbench](https://github.com/ckdvs99/autogen/tree/main/python/packages/autogen-ext/src/autogen_ext/tools/mcp): `python/packages/autogen-ext/src/autogen_ext/tools/mcp`
- [.NET model clients](https://github.com/ckdvs99/autogen/blob/main/dotnet/src/AutoGen.Anthropic/AnthropicClient.cs): `dotnet/src/AutoGen.Anthropic/AnthropicClient.cs`

### Studio application

- [Studio UI](https://github.com/ckdvs99/autogen/blob/main/python/packages/autogen-studio/frontend/src/components/views/playground/manager.tsx): `python/packages/autogen-studio/frontend/src/components/views/playground/manager.tsx`
- [Studio service](https://github.com/ckdvs99/autogen/blob/main/python/packages/autogen-studio/autogenstudio/web/app.py): `python/packages/autogen-studio/autogenstudio/web/app.py`
- [Team manager](https://github.com/ckdvs99/autogen/blob/main/python/packages/autogen-studio/autogenstudio/teammanager/teammanager.py): `python/packages/autogen-studio/autogenstudio/teammanager/teammanager.py`
- [Studio database](https://github.com/ckdvs99/autogen/blob/main/python/packages/autogen-studio/autogenstudio/database/db_manager.py): `python/packages/autogen-studio/autogenstudio/database/db_manager.py`

### Developer tools

- [Benchmark suite](https://github.com/ckdvs99/autogen/blob/main/python/packages/agbench/src/agbench/run_cmd.py): `python/packages/agbench/src/agbench/run_cmd.py`

### Other components

- **User**

## Connections

- User → Assistant agent: submits task (evidence: `README.md`)
- Assistant agent → Model client API: requests completion (evidence: `README.md`)
- Model client API → Model providers: implemented by (evidence: `README.md`)
- Assistant agent → Chat messages: uses messages
- Agent teams → Assistant agent: coordinates agents (evidence: `README.md`)
- Agent teams → Task result: returns result
- Routed agents → Agent runtime: runs within
- Agent runtime → Agent identity: routes by identity
- Agent runtime → Core messages: passes messages
- Assistant agent → Core messages: built on Core (evidence: `README.md`)
- Assistant agent → Web browsing: can use browsing (evidence: `README.md`)
- Assistant agent → MCP workbench: can use workbench (evidence: `README.md`)
- Studio UI → Studio service: uses service
- Studio service → Team manager: runs teams
- Team manager → Agent teams: creates teams
- Studio service → Studio database: persists data
- Benchmark suite → Agent teams: evaluates agents
- .NET AgentChat → .NET Core API: built on Core (evidence: `README.md`)
- .NET model clients → .NET Core API: extends framework
