How kumarmageshr/n8n works
n8n is a self-hostable workflow-automation platform: users assemble workflows in the editor, configure integrations, and run automations. The map highlights workflow authoring and execution, execution state, integration nodes, and AI capabilities, alongside OAuth and binary-data support. The README documents broad capabilities such as code, 400+ integrations, and AI workflows. Several runtime modules are named in the SOURCE INDEX but were not excerpted; uncertain connections are omitted or shown as unverified.
Main entry points: workflows.controller.ts Workflow API · workflow-execution.service.ts Workflow execution service · node-execution-context.ts Node execution context · webhook-context.ts Webhook context
Components 19
Workflow authoring
- Workflow editor
packages/frontend/editor-ui/src/App.vue - Workflow API
packages/cli/src/workflows/workflows.controller.ts - Workflow service
packages/cli/src/workflows/workflow.service.ts - Workflow finder
packages/cli/src/workflows/workflow-finder.service.ts
Execution runtime
- Workflow execution service
packages/cli/src/workflows/workflow-execution.service.ts - Execution service
packages/cli/src/executions/execution.service.ts - Active workflows
packages/cli/src/active-workflow-manager.ts - Node execution context
packages/core/src/execution-engine/node-execution-context/node-execution-context.ts - Webhook context
packages/core/src/execution-engine/node-execution-context/webhook-context.ts - Binary data storage
packages/core/src/binary-data/file-system.manager.ts
Nodes and integrations
- Cloud storage node
packages/nodes-base/nodes/Google/CloudStorage/GoogleCloudStorage.node.ts - Azure Storage node
packages/nodes-base/nodes/Microsoft/Storage/AzureStorage.node.ts
Platform services
- Workflow and execution data
packages/@n8n/db/src/entities - OAuth2 client
packages/@n8n/client-oauth2/src/client-oauth2.ts
AI capabilities
- AI workflow builder
packages/@n8n/ai-workflow-builder.ee/src/ai-workflow-builder-agent.service.ts - Node search engine
packages/@n8n/ai-workflow-builder.ee/src/tools/engines/node-search-engine.ts - LangChain memory node
packages/@n8n/nodes-langchain/nodes/memory/MemoryManager/MemoryManager.node.ts
Other components
- Technical user
- External services
Connections 18
- Technical user → Workflow editor: authors in
README.md - Workflow editor → Workflow API: manages workflows
- Workflow API → Workflow service: delegates
packages/cli/src/workflows/workflows.controller.ts - Workflow API → Workflow finder: looks up
packages/cli/src/workflows/workflows.controller.ts - Workflow API → Workflow execution service: starts runs
packages/cli/src/workflows/workflows.controller.ts - Workflow execution service → Execution service: records runs
- Execution service → Workflow and execution data: persists state
- Active workflows → Workflow execution service: manages activation
- Workflow execution service → Node execution context: executes nodes
- Webhook context → Node execution context: provides context
packages/core/src/execution-engine/node-execution-context/webhook-context.ts - Webhook context → Binary data storage: copies binary data
packages/core/src/execution-engine/node-execution-context/webhook-context.ts - Node execution context → Cloud storage node: runs node
- Cloud storage node → External services: accesses cloud storage
- Azure Storage node → External services: accesses Azure
- Azure Storage node → OAuth2 client: supports OAuth2
- Technical user → AI workflow builder: requests AI workflow
- AI workflow builder → Node search engine: searches nodes
- LangChain memory node → External services: uses AI ecosystem