# langchain-ai/langgraphjs-api architecture

> Architecture diagram of the GitHub repository langchain-ai/langgraphjs-api, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-05-20). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/langchain-ai/langgraphjs-api
- Repository: https://github.com/langchain-ai/langgraphjs-api

## Overview

##### Project type and purpose
- This is a **monorepo** (managed by pnpm workspaces and turbo) hosting four interrelated packages:
- `create-langgraph`: CLI scaffolding tool for new LangGraph.js projects
- `langgraph-api`: In-memory JavaScript implementation of a LangGraph server (HTTP API, graph parser, persistence)
- `langgraph-cli`: End-user CLI orchestrator (commands for dev, build, Docker, Cloudflare)
- `langgraph-ui`: Static frontend bundler/templating for visualizing graphs
- It’s primarily a **tooling platform** for building, running, and visualizing LangGraph workflows.

##### File structure for architectural patterns
- **Top-level monorepo controls**:
- `pnpm-workspace.yaml`, `turbo.json`—workspace orchestration
- **Package boundaries**: each `libs/<pkg>` folder is an npm package
- **Service vs. tools**:
- `langgraph-api` behaves like a microservice (HTTP, storage, auth)
- `langgraph-cli` and `create-langgraph` are CLIs (Node.js entry points, IPC, Docker)
- `langgraph-ui` outputs static assets (bundler, templating)

##### README for stack & dependencies
- Core technologies: Node.js, TypeScript (MJS/TS), Hono (HTTP middleware), Docker, Cloudflare
- Build scripts: each package has `scripts/build.mjs`, `clean.mjs`, etc.
- Testing harness under `langgraph-api/tests` and `langgraph-cli/tests`

##### Main components & interactions
a. Components
- Developer Workstation (Terminal, Editor)
- `create-langgraph` CLI (scaffold)
- `langgraph-cli` (orchestration CLI)
- `langgraph-api` service (HTTP server, in-memory graph engine, persistence)
- `langgraph-ui` frontend (static assets, templating)
- External runtimes/services: Docker Engine, Cloudflare Workers
b. Relationships & Data Flow
1. Developer invokes `create-langgraph` → generates project skeleton
2. Developer uses `langgraph-cli dev` →
- Starts `langgraph-api` server (via IPC or Docker)
- Builds & serves `langgraph-ui` assets (via bundler or Docker/Cloudflare)
- Connects UI → API over HTTP
3. For production, `langgraph-cli up|build|docker|cloudflare` orchestrates containers or deploys Worker
c. Architectural patterns
- **Monorepo modularity**: separate packages, shared types & utils
- **CLI-to-service orchestration**: IPC channels, child processes, Docker Compose
- **API microservice**: HTTP endpoints, middleware, store abstraction, queue
- **Static-site generation**: bundler template → HTML/JS assets
d. Key technologies
- Node.js & TypeScript (MTS)
- Hono (HTTP framework in langgraph-api)
- IPC utilities for CLI orchestration
- Docker Compose, Cloudflare Workers
- pnpm & turbo for workspace/task orchestration

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Developer
    Dev["Developer Workstation"]:::ext

    %% CLI Tools Layer
    subgraph "CLI Tools Layer"
        direction TB
        CLIG["create-langgraph CLI<br/>(Scaffold)"]:::cli
        OCLI["langgraph-cli<br/>(Orchestrator)"]:::cli
    end

    Dev -->|"invoke scaffold"| CLIG
    Dev -->|"run commands"| OCLI

    %% Service Layer
    subgraph "Service Layer"
        direction TB
        APIEntry["API Entrypoint CLI"]:::api
        APIServer["Server Bootstrap<br/>(server.mts)"]:::api
        APIRoutes["HTTP Endpoints<br/>(api/*.mts)"]:::api
        AuthMW["Auth Middleware<br/>(auth/index.mts)"]:::api
        Parser["Graph Parser<br/>(graph/parser)"]:::api
        Storage["In-Memory Store & Persistence<br/>(storage)"]:::api
        Queue["Queue & Loopback<br/>(queue.mts, loopback.mts)"]:::api
        APIUtils["Utilities<br/>(utils)"]:::api
    end

    OCLI -->|"spawn via IPC"| APIEntry
    APIEntry --> APIServer
    APIServer --> APIRoutes
    APIRoutes --> AuthMW
    APIRoutes --> Parser
    APIRoutes --> Storage
    APIRoutes --> Queue
    APIRoutes --> APIUtils

    %% Frontend Layer
    subgraph "Frontend Layer"
        direction TB
        UILocal["UI CLI<br/>(cli.mts)"]:::ui
        UIBundler["Bundler Integration<br/>(bundler.mts)"]:::ui
        UITemplate["Template Renderer<br/>(render.template.mts)"]:::ui
        UIRender["Main Render Pipeline<br/>(index.mts)"]:::ui
        UIApiClient["API Client Abstraction<br/>(api.mts)"]:::ui
        UIScripts["Build & Clean Scripts<br/>(scripts)"]:::ui
    end

    OCLI -->|"start UI dev"| UILocal
    UILocal --> UIBundler
    UIBundler --> UITemplate
    UITemplate --> UIRender
    UIRender --> UIApiClient
    UIApiClient -->|"HTTP REST"| APIRoutes

    %% External Services
    subgraph "External Services"
        direction TB
        Docker["Docker Engine"]:::ext
        CF["Cloudflare Workers"]:::ext
    end

    OCLI -->|"docker commands"| Docker
    OCLI -->|"cloudflare deploy"| CF

    %% Click Events
    click CLIG "https://github.com/langchain-ai/langgraphjs-api/blob/main/libs/create-langgraph/src/cli.mts"
    click CLIG "https://github.com/langchain-ai/langgraphjs-api/blob/main/libs/create-langgraph/scripts/build.mjs"
    click CLIG "https://github.com/langchain-ai/langgraphjs-api/blob/main/libs/create-langgraph/scripts/clean.mjs"

    click OCLI "https://github.com/langchain-ai/langgraphjs-api/blob/main/libs/langgraph-cli/src/cli/cli.mts"
    click OCLI "https://github.com/langchain-ai/langgraphjs-api/blob/main/libs/langgraph-cli/src/cli/dev.mts"
    click OCLI "https://github.com/langchain-ai/langgraphjs-api/blob/main/libs/langgraph-cli/src/cli/build.mts"
    click OCLI "https://github.com/langchain-ai/langgraphjs-api/blob/main/libs/langgraph-cli/src/cli/docker.mts"
    click OCLI "https://github.com/langchain-ai/langgraphjs-api/blob/main/libs/langgraph-cli/src/cli/cloudflare.mts"
    click OCLI "https://github.com/langchain-ai/langgraphjs-api/blob/main/libs/langgraph-cli/src/cli/up.mts"
    click OCLI "https://github.com/langchain-ai/langgraphjs-api/tree/main/libs/langgraph-cli/src/cli/utils/ipc"
    click OCLI "https://github.com/langchain-ai/langgraphjs-api/blob/main/libs/langgraph-cli/src/docker/compose.mts"
    click OCLI "https://github.com/langchain-ai/langgraphjs-api/blob/main/libs/langgraph-cli/src/docker/docker.mts"
    click OCLI "https://github.com/langchain-ai/langgraphjs-api/blob/main/libs/langgraph-cli/src/docker/shell.mts"
    click OCLI "https://github.com/langchain-ai/langgraphjs-api/blob/main/libs/langgraph-cli/scripts/build.mjs"
    click OCLI "https://github.com/langchain-ai/langgraphjs-api/blob/main/libs/langgraph-cli/scripts/clean.mjs"

    click APIEntry "https://github.com/langchain-ai/langgraphjs-api/blob/main/libs/langgraph-api/src/cli/entrypoint.mts"
    click APIServer "https://github.com/langchain-ai/langgraphjs-api/blob/main/libs/langgraph-api/src/server.mts"
    click APIRoutes "https://github.com/langchain-ai/langgraphjs-api/blob/main/libs/langgraph-api/src/api/assistants.mts"
    click APIRoutes "https://github.com/langchain-ai/langgraphjs-api/blob/main/libs/langgraph-api/src/api/meta.mts"
    click APIRoutes "https://github.com/langchain-ai/langgraphjs-api/blob/main/libs/langgraph-api/src/api/runs.mts"
    click APIRoutes "https://github.com/langchain-ai/langgraphjs-api/blob/main/libs/langgraph-api/src/api/store.mts"
    click APIRoutes "https://github.com/langchain-ai/langgraphjs-api/blob/main/libs/langgraph-api/src/api/threads.mts"
    click AuthMW "https://github.com/langchain-ai/langgraphjs-api/blob/main/libs/langgraph-api/src/auth/index.mts"
    click Parser "https://github.com/langchain-ai/langgraphjs-api/tree/main/libs/langgraph-api/src/graph/parser"
    click Storage "https://github.com/langchain-ai/langgraphjs-api/blob/main/libs/langgraph-api/src/storage/checkpoint.mts"
    click Storage "https://github.com/langchain-ai/langgraphjs-api/blob/main/libs/langgraph-api/src/storage/store.mts"
    click Storage "https://github.com/langchain-ai/langgraphjs-api/blob/main/libs/langgraph-api/src/storage/persist.mts"
    click Queue "https://github.com/langchain-ai/langgraphjs-api/blob/main/libs/langgraph-api/src/queue.mts"
    click Queue "https://github.com/langchain-ai/langgraphjs-api/blob/main/libs/langgraph-api/src/loopback.mts"
    click APIUtils "https://github.com/langchain-ai/langgraphjs-api/tree/main/libs/langgraph-api/src/utils"

    click UILocal "https://github.com/langchain-ai/langgraphjs-api/blob/main/libs/langgraph-ui/src/cli.mts"
    click UIBundler "https://github.com/langchain-ai/langgraphjs-api/blob/main/libs/langgraph-ui/src/bundler.mts"
    click UITemplate "https://github.com/langchain-ai/langgraphjs-api/blob/main/libs/langgraph-ui/src/render.template.mts"
    click UIRender "https://github.com/langchain-ai/langgraphjs-api/blob/main/libs/langgraph-ui/src/index.mts"
    click UIApiClient "https://github.com/langchain-ai/langgraphjs-api/blob/main/libs/langgraph-ui/src/api.mts"
    click UIScripts "https://github.com/langchain-ai/langgraphjs-api/blob/main/libs/langgraph-ui/scripts/build.mjs"
    click UIScripts "https://github.com/langchain-ai/langgraphjs-api/blob/main/libs/langgraph-ui/scripts/clean.mjs"

    click Dev "https://github.com/langchain-ai/langgraphjs-api/blob/main/pnpm-workspace.yaml"
    click Dev "https://github.com/langchain-ai/langgraphjs-api/blob/main/turbo.json"

    %% Styles
    classDef cli fill:#cce5ff,stroke:#333,stroke-width:1px
    classDef api fill:#d4edda,stroke:#333,stroke-width:1px
    classDef ui fill:#fff3cd,stroke:#333,stroke-width:1px
    classDef ext fill:#e2e3e5,stroke:#333,stroke-width:1px
```
