How n8n-io/n8n works
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: agent-runtime.ts Agent runtime · src Visual editor · execution.types.ts Workflow engine · apps.service.ts App service
Components 20
Workflow authoring
- Visual editor
packages/frontend/editor-ui/src - Node catalog
packages/@n8n/ai-utilities/src/node-catalog/search-engine.ts
Execution and integrations
- Workflow engine
packages/@n8n/engine/src/execution/execution.types.ts - Integration nodes
packages/nodes-base/nodes
AI capabilities
- Agent runtime
packages/@n8n/agents/src/runtime/loop/agent-runtime.ts - Model providers
packages/@n8n/agents/src/runtime/model/model-factory.ts - Agent tools
packages/@n8n/agents/src/runtime/tools/tool-call-runner.ts - Agent memory
packages/@n8n/agents/src/runtime/memory/memory-orchestrator.ts - Agent guardrails
packages/@n8n/agents/src/runtime/guardrails/guardrail-runner.ts - Vector stores
packages/@n8n/agents/src/vector-stores - AI workflow builder
packages/@n8n/ai-workflow-builder.ee/src/tools/engines/node-search-engine.ts
Platform services
- Apps API
packages/modules/apps/backend/src/apps.controller.ts - App service
packages/modules/apps/backend/src/apps.service.ts - App repository
packages/modules/apps/backend/src/app.repository.ts - App preview
packages/modules/apps/backend/src/preview/app-preview.controller.ts
Governance
- Dependency analysis
packages/cli/src/modules/workflow-index/workflow-dependency-query.service.ts - Migration findings
packages/cli/src/modules/breaking-changes/query/migration-finding-query.service.ts - Review authorization
packages/cli/src/modules/workflow-reviews.ee/workflow-review-authorization.service.ts - Review authors
packages/@n8n/db/src/repositories/workflow-review-request-author.repository.ts
Other components
- Workflow builder
Connections 15
- 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
packages/modules/apps/backend/src/apps.controller.ts - App service → App repository: persists apps
packages/modules/apps/backend/src/apps.service.ts - App preview → App service: previews apps
- Review authorization → Review authors: checks authorship
packages/cli/src/modules/workflow-reviews.ee/workflow-review-authorization.service.ts