diff --git a/computer-use-demo/README.md b/computer-use-demo/README.md
index 2b896da8..dbf5a901 100644
--- a/computer-use-demo/README.md
+++ b/computer-use-demo/README.md
@@ -27,6 +27,44 @@ Please use [this form](https://forms.gle/BT1hpBrqDPDUrCqo7) to provide feedback
 > [!IMPORTANT]
 > The components are weakly separated: the agent loop runs in the container being controlled by Claude, can only be used by one session at a time, and must be restarted or reset between sessions if necessary.
 
+## Architecture
+
+```mermaid
+architecture-beta
+    group docker(server)[Docker Ubuntu 22_04]
+    group anthropic[Anthropic]
+
+    service http_server(server)[http_server 8080] in docker
+    service noVNC(server)[noVNC 6080] in docker
+    service x11vnc(server)[x11vnc 5900] in docker
+    service Xvfb[Xvfb] in docker
+    service mutter[mutter] in docker
+    service tint2[tint2] in docker
+    service xdotool(server)[xdotool] in docker
+    service streamlit(server)[streamlit 8501] in docker
+    service claude(cloud)[Claude] in anthropic
+    junction one
+    junction two
+    junction three
+    junction four
+
+    http_server:R -- L:three
+    three:R --> L:noVNC
+    three:T -- B:four
+    four:R --> L:streamlit
+    noVNC:R --> L:x11vnc
+    streamlit:R --> L:xdotool
+    streamlit:T --> B:claude
+    x11vnc:R -- L:one
+    one:R -- L:mutter
+    one:T -- B:two
+    two:R -- L:tint2
+    tint2:T -- B:Xvfb
+    mutter:T -- B:tint2
+    xdotool:R -- L:two
+```
+
+
 ## Quickstart: running the Docker container
 
 ### Anthropic API