# daytonaio/daytona architecture

> Architecture diagram of the GitHub repository daytonaio/daytona, 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/daytonaio/daytona
- Repository: https://github.com/daytonaio/daytona

## Overview

Daytona is documented as secure, elastic infrastructure for executing AI-generated code and agent workflows in isolated, persistent sandboxes. The principal workflow is developers or agents using client interfaces to request sandbox operations, which the control plane orchestrates and the compute plane runs. The README also documents platform governance, sandbox configuration and persistence, agent tools, human access, and system hooks. The supplied tree contains no implementation sources, so component paths and internal capability links are unavailable; relationships shown are limited to those stated in the README.

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interfaces["Interface plane"]
  node_sdk["SDKs"]
  node_api["API"]
  node_cli["CLI"]
end

subgraph group_control["Control plane"]
  node_sandbox_control["Sandbox orchestration"]
  node_platform_governance["Platform governance"]
  node_organizations_limits["Organizations and limits"]
  node_billing_audit["Billing and audit"]
end

subgraph group_compute["Compute plane"]
  node_sandbox["Isolated sandboxes"]
  node_environment["Environment configuration"]
  node_snapshots[("Persistent snapshots")]
  node_agent_tools["Agent tools"]
  node_human_tools["Human tools"]
  node_system_tools["System tools"]
end

node_developers_agents(("Developers and agents"))

node_developers_agents -->|"use"| node_sdk
node_developers_agents -->|"use"| node_api
node_developers_agents -->|"use"| node_cli
node_sdk -->|"interact with"| node_sandbox_control
node_api -->|"interact with"| node_sandbox_control
node_cli -->|"interact with"| node_sandbox_control
node_sandbox_control -->|"orchestrates"| node_sandbox
node_sandbox -->|"retain state"| node_snapshots

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_sdk,node_api,node_cli toneBlue
class node_sandbox_control,node_platform_governance,node_organizations_limits,node_billing_audit toneAmber
class node_sandbox,node_environment,node_snapshots,node_agent_tools,node_human_tools,node_system_tools toneMint
class node_developers_agents toneIndigo
```

## Components

### Interface plane

- **SDKs**
- **API**
- **CLI**

### Control plane

- **Sandbox orchestration**
- **Platform governance**
- **Organizations and limits**
- **Billing and audit**

### Compute plane

- **Isolated sandboxes**
- **Environment configuration**
- **Persistent snapshots**
- **Agent tools**
- **Human tools**
- **System tools**

### Other components

- **Developers and agents**

## Connections

- Developers and agents → SDKs: use (evidence: `README.md`)
- Developers and agents → API: use (evidence: `README.md`)
- Developers and agents → CLI: use (evidence: `README.md`)
- SDKs → Sandbox orchestration: interact with (evidence: `README.md`)
- API → Sandbox orchestration: interact with (evidence: `README.md`)
- CLI → Sandbox orchestration: interact with (evidence: `README.md`)
- Sandbox orchestration → Isolated sandboxes: orchestrates (evidence: `README.md`)
- Isolated sandboxes → Persistent snapshots: retain state (evidence: `README.md`)
