# n8n-io/n8n architecture

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

- Interactive diagram: https://gitdiagram.com/n8n-io/n8n
- Repository: https://github.com/n8n-io/n8n
- Video tour (about a minute): https://gitdiagram.com/n8n-io/n8n/video

## Overview

n8n is a visual workflow-automation platform that also supports AI agents, custom code, and integrations. The principal user journey is to design a multi-step workflow in the editor, configure its nodes and models, then deploy it to run against connected services. Supporting branches include reusable AI-agent runtime capabilities, app hosting, dependency and migration analysis, and workflow review authorization. The tree and README establish the product scope; sampled excerpts verify only selected service calls, so other relationships are documented at a broad capability level rather than inferred from module names.

Main entry points: [`packages/@n8n/agents/src/runtime/loop/agent-runtime.ts`](https://github.com/n8n-io/n8n/blob/master/packages/%40n8n/agents/src/runtime/loop/agent-runtime.ts) (Agent runtime), [`packages/frontend/editor-ui/src`](https://github.com/n8n-io/n8n/tree/master/packages/frontend/editor-ui/src) (Visual editor), [`packages/@n8n/engine/src/execution/execution.types.ts`](https://github.com/n8n-io/n8n/blob/master/packages/%40n8n/engine/src/execution/execution.types.ts) (Workflow engine), [`packages/modules/apps/backend/src/apps.service.ts`](https://github.com/n8n-io/n8n/blob/master/packages/modules/apps/backend/src/apps.service.ts) (App service)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_authoring["Workflow authoring"]
  node_editor["Visual editor"]
  node_nodecatalog["Node catalog<br/>[search-engine.ts]"]
end

subgraph group_execution["Execution and integrations"]
  node_workflow_engine["Workflow engine<br/>[execution.types.ts]"]
  node_integrations["Integration nodes"]
end

subgraph group_ai["AI capabilities"]
  node_agent_runtime["Agent runtime<br/>[agent-runtime.ts]"]
  node_model_providers["Model providers<br/>[model-factory.ts]"]
  node_agent_tools["Agent tools"]
  node_agent_memory["Agent memory"]
  node_agent_guardrails["Agent guardrails"]
  node_vector_stores[("Vector stores")]
  node_workflow_builder_ai["AI workflow builder"]
end

subgraph group_platform["Platform services"]
  node_apps_api["Apps API<br/>[apps.controller.ts]"]
  node_apps_service["App service<br/>[apps.service.ts]"]
  node_app_repository[("App repository<br/>[app.repository.ts]")]
  node_app_preview["App preview"]
end

subgraph group_governance["Governance"]
  node_workflow_dependencies["Dependency analysis"]
  node_migration_findings["Migration findings"]
  node_review_authorization["Review authorization"]
  node_review_author_repository[("Review authors")]
end

node_user(("Workflow builder"))

node_user -->|"designs workflows"| node_editor
node_editor -.->|"finds nodes"| node_nodecatalog
node_editor -->|"configures workflows"| node_workflow_engine
node_workflow_engine -->|"runs integrations"| node_integrations
node_workflow_engine -->|"runs agents"| node_agent_runtime
node_agent_runtime -->|"uses models"| node_model_providers
node_agent_runtime -->|"uses tools"| node_agent_tools
node_agent_runtime -.->|"uses memory"| node_agent_memory
node_agent_runtime -->|"applies guardrails"| node_agent_guardrails
node_agent_memory -.->|"uses stores"| node_vector_stores
node_workflow_builder_ai -.->|"searches nodes"| node_nodecatalog
node_apps_api -->|"dispatches requests"| node_apps_service
node_apps_service -->|"persists apps"| node_app_repository
node_app_preview -.->|"previews apps"| node_apps_service
node_review_authorization -->|"checks authorship"| node_review_author_repository

click node_editor "https://github.com/n8n-io/n8n/tree/master/packages/frontend/editor-ui/src"
click node_nodecatalog "https://github.com/n8n-io/n8n/blob/master/packages/%40n8n/ai-utilities/src/node-catalog/search-engine.ts"
click node_workflow_engine "https://github.com/n8n-io/n8n/blob/master/packages/%40n8n/engine/src/execution/execution.types.ts"
click node_integrations "https://github.com/n8n-io/n8n/tree/master/packages/nodes-base/nodes"
click node_agent_runtime "https://github.com/n8n-io/n8n/blob/master/packages/%40n8n/agents/src/runtime/loop/agent-runtime.ts"
click node_model_providers "https://github.com/n8n-io/n8n/blob/master/packages/%40n8n/agents/src/runtime/model/model-factory.ts"
click node_agent_tools "https://github.com/n8n-io/n8n/blob/master/packages/%40n8n/agents/src/runtime/tools/tool-call-runner.ts"
click node_agent_memory "https://github.com/n8n-io/n8n/blob/master/packages/%40n8n/agents/src/runtime/memory/memory-orchestrator.ts"
click node_agent_guardrails "https://github.com/n8n-io/n8n/blob/master/packages/%40n8n/agents/src/runtime/guardrails/guardrail-runner.ts"
click node_vector_stores "https://github.com/n8n-io/n8n/tree/master/packages/%40n8n/agents/src/vector-stores"
click node_workflow_builder_ai "https://github.com/n8n-io/n8n/blob/master/packages/%40n8n/ai-workflow-builder.ee/src/tools/engines/node-search-engine.ts"
click node_apps_api "https://github.com/n8n-io/n8n/blob/master/packages/modules/apps/backend/src/apps.controller.ts"
click node_apps_service "https://github.com/n8n-io/n8n/blob/master/packages/modules/apps/backend/src/apps.service.ts"
click node_app_repository "https://github.com/n8n-io/n8n/blob/master/packages/modules/apps/backend/src/app.repository.ts"
click node_app_preview "https://github.com/n8n-io/n8n/blob/master/packages/modules/apps/backend/src/preview/app-preview.controller.ts"
click node_workflow_dependencies "https://github.com/n8n-io/n8n/blob/master/packages/cli/src/modules/workflow-index/workflow-dependency-query.service.ts"
click node_migration_findings "https://github.com/n8n-io/n8n/blob/master/packages/cli/src/modules/breaking-changes/query/migration-finding-query.service.ts"
click node_review_authorization "https://github.com/n8n-io/n8n/blob/master/packages/cli/src/modules/workflow-reviews.ee/workflow-review-authorization.service.ts"
click node_review_author_repository "https://github.com/n8n-io/n8n/blob/master/packages/%40n8n/db/src/repositories/workflow-review-request-author.repository.ts"

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_editor,node_nodecatalog toneBlue
class node_workflow_engine,node_integrations toneAmber
class node_agent_runtime,node_model_providers,node_agent_tools,node_agent_memory,node_agent_guardrails,node_vector_stores,node_workflow_builder_ai toneMint
class node_apps_api,node_apps_service,node_app_repository,node_app_preview toneRose
class node_workflow_dependencies,node_migration_findings,node_review_authorization,node_review_author_repository,node_user toneIndigo
```

## Components

### Workflow authoring

- [Visual editor](https://github.com/n8n-io/n8n/tree/master/packages/frontend/editor-ui/src): `packages/frontend/editor-ui/src`
- [Node catalog](https://github.com/n8n-io/n8n/blob/master/packages/%40n8n/ai-utilities/src/node-catalog/search-engine.ts): `packages/@n8n/ai-utilities/src/node-catalog/search-engine.ts`

### Execution and integrations

- [Workflow engine](https://github.com/n8n-io/n8n/blob/master/packages/%40n8n/engine/src/execution/execution.types.ts): `packages/@n8n/engine/src/execution/execution.types.ts`
- [Integration nodes](https://github.com/n8n-io/n8n/tree/master/packages/nodes-base/nodes): `packages/nodes-base/nodes`

### AI capabilities

- [Agent runtime](https://github.com/n8n-io/n8n/blob/master/packages/%40n8n/agents/src/runtime/loop/agent-runtime.ts): `packages/@n8n/agents/src/runtime/loop/agent-runtime.ts`
- [Model providers](https://github.com/n8n-io/n8n/blob/master/packages/%40n8n/agents/src/runtime/model/model-factory.ts): `packages/@n8n/agents/src/runtime/model/model-factory.ts`
- [Agent tools](https://github.com/n8n-io/n8n/blob/master/packages/%40n8n/agents/src/runtime/tools/tool-call-runner.ts): `packages/@n8n/agents/src/runtime/tools/tool-call-runner.ts`
- [Agent memory](https://github.com/n8n-io/n8n/blob/master/packages/%40n8n/agents/src/runtime/memory/memory-orchestrator.ts): `packages/@n8n/agents/src/runtime/memory/memory-orchestrator.ts`
- [Agent guardrails](https://github.com/n8n-io/n8n/blob/master/packages/%40n8n/agents/src/runtime/guardrails/guardrail-runner.ts): `packages/@n8n/agents/src/runtime/guardrails/guardrail-runner.ts`
- [Vector stores](https://github.com/n8n-io/n8n/tree/master/packages/%40n8n/agents/src/vector-stores): `packages/@n8n/agents/src/vector-stores`
- [AI workflow builder](https://github.com/n8n-io/n8n/blob/master/packages/%40n8n/ai-workflow-builder.ee/src/tools/engines/node-search-engine.ts): `packages/@n8n/ai-workflow-builder.ee/src/tools/engines/node-search-engine.ts`

### Platform services

- [Apps API](https://github.com/n8n-io/n8n/blob/master/packages/modules/apps/backend/src/apps.controller.ts): `packages/modules/apps/backend/src/apps.controller.ts`
- [App service](https://github.com/n8n-io/n8n/blob/master/packages/modules/apps/backend/src/apps.service.ts): `packages/modules/apps/backend/src/apps.service.ts`
- [App repository](https://github.com/n8n-io/n8n/blob/master/packages/modules/apps/backend/src/app.repository.ts): `packages/modules/apps/backend/src/app.repository.ts`
- [App preview](https://github.com/n8n-io/n8n/blob/master/packages/modules/apps/backend/src/preview/app-preview.controller.ts): `packages/modules/apps/backend/src/preview/app-preview.controller.ts`

### Governance

- [Dependency analysis](https://github.com/n8n-io/n8n/blob/master/packages/cli/src/modules/workflow-index/workflow-dependency-query.service.ts): `packages/cli/src/modules/workflow-index/workflow-dependency-query.service.ts`
- [Migration findings](https://github.com/n8n-io/n8n/blob/master/packages/cli/src/modules/breaking-changes/query/migration-finding-query.service.ts): `packages/cli/src/modules/breaking-changes/query/migration-finding-query.service.ts`
- [Review authorization](https://github.com/n8n-io/n8n/blob/master/packages/cli/src/modules/workflow-reviews.ee/workflow-review-authorization.service.ts): `packages/cli/src/modules/workflow-reviews.ee/workflow-review-authorization.service.ts`
- [Review authors](https://github.com/n8n-io/n8n/blob/master/packages/%40n8n/db/src/repositories/workflow-review-request-author.repository.ts): `packages/@n8n/db/src/repositories/workflow-review-request-author.repository.ts`

### Other components

- **Workflow builder**

## Connections

- Workflow builder → Visual editor: designs workflows
- Visual editor → Node catalog: finds nodes
- Visual editor → Workflow engine: configures workflows
- Workflow engine → Integration nodes: runs integrations
- Workflow engine → Agent runtime: runs agents
- Agent runtime → Model providers: uses models
- Agent runtime → Agent tools: uses tools
- Agent runtime → Agent memory: uses memory
- Agent runtime → Agent guardrails: applies guardrails
- Agent memory → Vector stores: uses stores
- AI workflow builder → Node catalog: searches nodes
- Apps API → App service: dispatches requests (evidence: `packages/modules/apps/backend/src/apps.controller.ts`)
- App service → App repository: persists apps (evidence: `packages/modules/apps/backend/src/apps.service.ts`)
- App preview → App service: previews apps
- Review authorization → Review authors: checks authorship (evidence: `packages/cli/src/modules/workflow-reviews.ee/workflow-review-authorization.service.ts`)
