OpenHands System Architecture (Canvas + Agent Server + SDK)

OpenHands System Architecture (Canvas + Agent Server + SDK) An architecture diagram generated by Archify. Browser · Agent Canvas SPA · Architecture component · OpenHands/OpenHands Browser Agent Canvas SPA OpenHands/OpenHands Canvas stack · ingress :8000 · Architecture component · OpenHands/OpenHands Canvas stack ingress :8000 OpenHands/OpenHands Automation svc · schedules + webhooks · Architecture component · OpenHands/automation Automation svc schedules + webhooks OpenHands/automation Docker runtime · container per conversation · Architecture component Docker runtime container per conversation Agent Server · FastAPI /api + /sockets · agent-server process (Python) Agent Server FastAPI /api + /sockets EventService · one per conversation · agent-server process (Python) EventService one per conversation LocalConversation · loop + state lock · agent-server process (Python) LocalConversation loop + state lock Conversation dir · base_state + events/ · Architecture component Conversation dir base_state + events/ Agent · stateless step() · agent-server process (Python) Agent stateless step() LLM provider · LiteLLM boundary · Architecture component LLM provider LiteLLM boundary Tools · terminal, editor, MCP · agent-server process (Python) Tools terminal, editor, MCP Workspace · tmux, files, git · Architecture component Workspace tmux, files, git HTTP + WS /api, /sockets REST runs start/send/run proxy arun() task persist step() generate actions side effects agent-server process (Python) Legend Frontend Backend Database Cloud Security Message bus External