# cpacker/memgpt architecture

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

- Interactive diagram: https://gitdiagram.com/cpacker/memgpt
- Repository: https://github.com/cpacker/memgpt

## Overview

This repository contains no application source in the supplied tree. Its README describes Letta as a platform for stateful agents and directs active development to the separate letta-code project. The diagram therefore captures only documented ways to use the product; it does not infer internal runtime components or wiring.

Main entry points: [`README.md`](https://github.com/cpacker/memgpt/blob/main/README.md) (Product overview)

## Diagram (Mermaid)

```mermaid
flowchart TD

node_user(("Letta user"))
node_readme["Product overview<br/>[README.md]"]
node_npm["Letta CLI package"]
node_terminal["Terminal UI"]
node_server["App Server"]
node_runtime["Agent runtime"]
node_desktop["Desktop app"]
node_web["Web app"]
node_channels["Messaging channels"]
node_sdk["Agent SDK"]
node_cloud["Letta Cloud"]

node_readme -.->|"identifies active source"| node_runtime
node_user -->|"installs"| node_npm
node_user -->|"launches"| node_terminal
node_user -->|"runs"| node_server
node_user -.->|"uses"| node_desktop
node_user -.->|"uses"| node_web
node_user -.->|"uses"| node_channels
node_user -.->|"builds with"| node_sdk
node_user -.->|"uses"| node_cloud

click node_readme "https://github.com/cpacker/memgpt/blob/main/README.md"

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_user,node_readme,node_terminal toneBlue
class node_npm,node_runtime,node_desktop,node_web,node_channels,node_sdk,node_cloud toneIndigo
class node_server toneMint
```

## Components

### Other components

- **Letta user**
- [Product overview](https://github.com/cpacker/memgpt/blob/main/README.md): `README.md`
- **Letta CLI package**
- **Terminal UI**
- **App Server**
- **Agent runtime**
- **Desktop app**
- **Web app**
- **Messaging channels**
- **Agent SDK**
- **Letta Cloud**

## Connections

- Product overview → Agent runtime: identifies active source
- Letta user → Letta CLI package: installs
- Letta user → Terminal UI: launches
- Letta user → App Server: runs
- Letta user → Desktop app: uses
- Letta user → Web app: uses
- Letta user → Messaging channels: uses
- Letta user → Agent SDK: builds with
- Letta user → Letta Cloud: uses
