# openbmb/chatdev architecture

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

- Interactive diagram: https://gitdiagram.com/openbmb/chatdev
- Repository: https://github.com/openbmb/chatdev

## Overview

DevAll is a zero-code multi-agent workflow platform. A user designs a workflow in the Vue frontend, submits YAML or editor data through the server, and receives an executed workflow result. The runtime validates configuration, builds graph topology and cycles, schedules node execution, invokes agents, models, skills, and tools, then records sessions and artifacts. The tree documents broad integrations and batch/websocket operation; several server-to-runtime call sites were not sampled, so those relationships are represented conservatively.

Main entry points: [`runtime/node/executor/agent_executor.py`](https://github.com/openbmb/chatdev/blob/main/runtime/node/executor/agent_executor.py) (Agent Executor), [`server/services/session_execution.py`](https://github.com/openbmb/chatdev/blob/main/server/services/session_execution.py) (Session Execution), [`server/app.py`](https://github.com/openbmb/chatdev/blob/main/server/app.py) (API Server), [`frontend/src/App.vue`](https://github.com/openbmb/chatdev/blob/main/frontend/src/App.vue) (Vue Workbench)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_authoring["Workflow Authoring"]
  node_frontend["Vue Workbench<br/>[App.vue]"]
  node_workflow_yaml["Workflow YAML"]
end

subgraph group_server["Server Services"]
  node_config_validation["Config Validation<br/>[check.py]"]
  node_api_server["API Server<br/>[app.py]"]
  node_session_service["Session Execution"]
  node_batch_service["Batch Runs"]
end

subgraph group_orchestration["Workflow Orchestration"]
  node_runtime_builder["Runtime Builder<br/>[runtime_builder.py]"]
  node_graph_manager["Graph Manager<br/>[graph_manager.py]"]
  node_cycle_manager["Cycle Manager<br/>[cycle_manager.py]"]
  node_workflow_execution["Workflow Execution<br/>[dag_executor.py]"]
  node_resource_manager["Resource Manager"]
end

subgraph group_runtime["Agent Runtime"]
  node_agent_executor["Agent Executor<br/>[agent_executor.py]"]
  node_thinking["Thinking Manager"]
  node_skills["Agent Skills<br/>[manager.py]"]
  node_tool_manager["Tool Manager<br/>[tool_manager.py]"]
  node_function_manager["Function Manager"]
  node_function_tools["Function Tools"]
  node_llm_providers["LLM Providers"]
end

subgraph group_results["Results and State"]
  node_vuegraph_store[("Vuegraph Store")]
  node_session_store[("Session Store<br/>[session_store.py]")]
  node_artifact_dispatcher["Artifact Dispatcher"]
  node_workflow_result["Workflow Result<br/>[result_archiver.py]"]
end

node_user(("User"))
node_mcp_services["MCP Services"]

node_user -->|"designs workflows"| node_frontend
node_frontend -->|"submits requests"| node_api_server
node_frontend -->|"stores editor data"| node_vuegraph_store
node_api_server -->|"validates config"| node_config_validation
node_config_validation -->|"checks YAML"| node_workflow_yaml
node_api_server -->|"starts sessions"| node_session_service
node_api_server -->|"starts batches"| node_batch_service
node_session_service -->|"builds runtime"| node_runtime_builder
node_batch_service -->|"runs sessions"| node_session_service
node_runtime_builder -->|"constructs graph"| node_graph_manager
node_graph_manager -->|"manages cycles"| node_cycle_manager
node_graph_manager -->|"prepares execution"| node_workflow_execution
node_workflow_execution -->|"coordinates resources"| node_resource_manager
node_workflow_execution -->|"dispatches agents"| node_agent_executor
node_resource_manager -->|"guards execution"| node_agent_executor
node_agent_executor -->|"invokes thinking"| node_thinking
node_agent_executor -->|"loads skills"| node_skills
node_agent_executor -->|"requests tools"| node_tool_manager
node_agent_executor -->|"calls models"| node_llm_providers
node_tool_manager -->|"loads functions"| node_function_manager
node_function_manager -->|"discovers tools"| node_function_tools
node_tool_manager -.->|"calls MCP"| node_mcp_services
node_session_service -->|"records session"| node_session_store
node_session_service -->|"dispatches artifacts"| node_artifact_dispatcher
node_artifact_dispatcher -->|"archives results"| node_workflow_result

click node_frontend "https://github.com/openbmb/chatdev/blob/main/frontend/src/App.vue"
click node_workflow_yaml "https://github.com/openbmb/chatdev/blob/main/server/services/workflow_storage.py"
click node_config_validation "https://github.com/openbmb/chatdev/blob/main/check/check.py"
click node_api_server "https://github.com/openbmb/chatdev/blob/main/server/app.py"
click node_session_service "https://github.com/openbmb/chatdev/blob/main/server/services/session_execution.py"
click node_batch_service "https://github.com/openbmb/chatdev/blob/main/server/services/batch_run_service.py"
click node_vuegraph_store "https://github.com/openbmb/chatdev/blob/main/server/services/vuegraphs_storage.py"
click node_runtime_builder "https://github.com/openbmb/chatdev/blob/main/workflow/runtime/runtime_builder.py"
click node_graph_manager "https://github.com/openbmb/chatdev/blob/main/workflow/graph_manager.py"
click node_cycle_manager "https://github.com/openbmb/chatdev/blob/main/workflow/cycle_manager.py"
click node_workflow_execution "https://github.com/openbmb/chatdev/blob/main/workflow/executor/dag_executor.py"
click node_resource_manager "https://github.com/openbmb/chatdev/blob/main/workflow/executor/resource_manager.py"
click node_agent_executor "https://github.com/openbmb/chatdev/blob/main/runtime/node/executor/agent_executor.py"
click node_thinking "https://github.com/openbmb/chatdev/blob/main/runtime/node/agent/thinking/thinking_manager.py"
click node_skills "https://github.com/openbmb/chatdev/blob/main/runtime/node/agent/skills/manager.py"
click node_tool_manager "https://github.com/openbmb/chatdev/blob/main/runtime/node/agent/tool/tool_manager.py"
click node_function_manager "https://github.com/openbmb/chatdev/blob/main/utils/function_manager.py"
click node_function_tools "https://github.com/openbmb/chatdev/tree/main/functions/function_calling"
click node_llm_providers "https://github.com/openbmb/chatdev/tree/main/runtime/node/agent/providers"
click node_session_store "https://github.com/openbmb/chatdev/blob/main/server/services/session_store.py"
click node_artifact_dispatcher "https://github.com/openbmb/chatdev/blob/main/server/services/artifact_dispatcher.py"
click node_workflow_result "https://github.com/openbmb/chatdev/blob/main/workflow/runtime/result_archiver.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_frontend,node_workflow_yaml,node_user toneBlue
class node_config_validation,node_api_server,node_session_service,node_batch_service toneAmber
class node_runtime_builder,node_graph_manager,node_cycle_manager,node_workflow_execution,node_resource_manager toneMint
class node_agent_executor,node_thinking,node_skills,node_tool_manager,node_function_manager,node_function_tools,node_llm_providers toneRose
class node_vuegraph_store,node_session_store,node_artifact_dispatcher,node_workflow_result,node_mcp_services toneIndigo
```

## Components

### Workflow Authoring

- [Vue Workbench](https://github.com/openbmb/chatdev/blob/main/frontend/src/App.vue): `frontend/src/App.vue`
- [Workflow YAML](https://github.com/openbmb/chatdev/blob/main/server/services/workflow_storage.py): `server/services/workflow_storage.py`

### Server Services

- [Config Validation](https://github.com/openbmb/chatdev/blob/main/check/check.py): `check/check.py`
- [API Server](https://github.com/openbmb/chatdev/blob/main/server/app.py): `server/app.py`
- [Session Execution](https://github.com/openbmb/chatdev/blob/main/server/services/session_execution.py): `server/services/session_execution.py`
- [Batch Runs](https://github.com/openbmb/chatdev/blob/main/server/services/batch_run_service.py): `server/services/batch_run_service.py`

### Workflow Orchestration

- [Runtime Builder](https://github.com/openbmb/chatdev/blob/main/workflow/runtime/runtime_builder.py): `workflow/runtime/runtime_builder.py`
- [Graph Manager](https://github.com/openbmb/chatdev/blob/main/workflow/graph_manager.py): `workflow/graph_manager.py`
- [Cycle Manager](https://github.com/openbmb/chatdev/blob/main/workflow/cycle_manager.py): `workflow/cycle_manager.py`
- [Workflow Execution](https://github.com/openbmb/chatdev/blob/main/workflow/executor/dag_executor.py): `workflow/executor/dag_executor.py`
- [Resource Manager](https://github.com/openbmb/chatdev/blob/main/workflow/executor/resource_manager.py): `workflow/executor/resource_manager.py`

### Agent Runtime

- [Agent Executor](https://github.com/openbmb/chatdev/blob/main/runtime/node/executor/agent_executor.py): `runtime/node/executor/agent_executor.py`
- [Thinking Manager](https://github.com/openbmb/chatdev/blob/main/runtime/node/agent/thinking/thinking_manager.py): `runtime/node/agent/thinking/thinking_manager.py`
- [Agent Skills](https://github.com/openbmb/chatdev/blob/main/runtime/node/agent/skills/manager.py): `runtime/node/agent/skills/manager.py`
- [Tool Manager](https://github.com/openbmb/chatdev/blob/main/runtime/node/agent/tool/tool_manager.py): `runtime/node/agent/tool/tool_manager.py`
- [Function Manager](https://github.com/openbmb/chatdev/blob/main/utils/function_manager.py): `utils/function_manager.py`
- [Function Tools](https://github.com/openbmb/chatdev/tree/main/functions/function_calling): `functions/function_calling`
- [LLM Providers](https://github.com/openbmb/chatdev/tree/main/runtime/node/agent/providers): `runtime/node/agent/providers`

### Results and State

- [Vuegraph Store](https://github.com/openbmb/chatdev/blob/main/server/services/vuegraphs_storage.py): `server/services/vuegraphs_storage.py`
- [Session Store](https://github.com/openbmb/chatdev/blob/main/server/services/session_store.py): `server/services/session_store.py`
- [Artifact Dispatcher](https://github.com/openbmb/chatdev/blob/main/server/services/artifact_dispatcher.py): `server/services/artifact_dispatcher.py`
- [Workflow Result](https://github.com/openbmb/chatdev/blob/main/workflow/runtime/result_archiver.py): `workflow/runtime/result_archiver.py`

### Other components

- **User**
- **MCP Services**

## Connections

- User → Vue Workbench: designs workflows
- Vue Workbench → API Server: submits requests
- Vue Workbench → Vuegraph Store: stores editor data
- API Server → Config Validation: validates config
- Config Validation → Workflow YAML: checks YAML
- API Server → Session Execution: starts sessions
- API Server → Batch Runs: starts batches
- Session Execution → Runtime Builder: builds runtime
- Batch Runs → Session Execution: runs sessions
- Runtime Builder → Graph Manager: constructs graph
- Graph Manager → Cycle Manager: manages cycles
- Graph Manager → Workflow Execution: prepares execution
- Workflow Execution → Resource Manager: coordinates resources
- Workflow Execution → Agent Executor: dispatches agents
- Resource Manager → Agent Executor: guards execution
- Agent Executor → Thinking Manager: invokes thinking
- Agent Executor → Agent Skills: loads skills
- Agent Executor → Tool Manager: requests tools
- Agent Executor → LLM Providers: calls models
- Tool Manager → Function Manager: loads functions
- Function Manager → Function Tools: discovers tools
- Tool Manager → MCP Services: calls MCP
- Session Execution → Session Store: records session
- Session Execution → Artifact Dispatcher: dispatches artifacts
- Artifact Dispatcher → Workflow Result: archives results
