How fares-ojel/n8n works
n8n is a self-hostable workflow-automation platform. The main user journey is to build or import a workflow, configure its nodes and integrations, then run it and inspect the outcome. The repository also contains an AI-agent runtime, node discovery, and workspace tools for code-enabled workflows. This map combines documented capabilities with sampled source and the source index; several core execution and editor subsystems are unsampled, so their connections are shown only where documented or evidenced by indexed references.
Main entry points: agent-runtime.ts Agent runtime · agent-execution-orchestrator.service.ts Agent orchestration · src Workflow editor · workflows.controller.ts Workflow API
Components 17
Workflow authoring
- Workflow editor
packages/frontend/editor-ui/src - Package import
packages/cli/src/modules/n8n-packages/engine/import-pipeline.ts - Workflow API
packages/cli/src/workflows/workflows.controller.ts - Node catalog search
packages/@n8n/ai-utilities/src/node-catalog/search-engine.ts
Workflow execution
- Execution engine
packages/core/src/execution-engine
AI capabilities
- Agent orchestration
packages/cli/src/modules/agents/agent-execution-orchestrator.service.ts - Agent runtime
packages/@n8n/agents/src/runtime/loop/agent-runtime.ts - Model handling
packages/@n8n/agents/src/runtime/model/model-factory.ts - Agent tools
packages/@n8n/agents/src/runtime/tools/tool-call-executor.ts - Agent memory
packages/@n8n/agents/src/runtime/memory/memory-orchestrator.ts - Agent streaming
packages/@n8n/agents/src/runtime/streaming/stream.ts - Code workspace
packages/@n8n/agents/src/workspace - Instance AI search
packages/@n8n/instance-ai/src/tools/nodes/node-search-engine.ts - Agent evaluations
packages/@n8n/agents/src/evals
Integrations and extensions
- Integration nodes
packages/nodes-base/nodes - Cloud storage node
packages/nodes-base/nodes/Google/CloudStorage/GoogleCloudStorage.node.ts
Other components
- Technical team
Connections 18
- Technical team → Workflow editor: builds workflows
README.md - Technical team → Package import: imports packages
README.md - Workflow editor → Workflow API: manages workflows
- Workflow API → Execution engine: runs workflows
- Workflow editor → Node catalog search: discovers nodes
- Execution engine → Integration nodes: executes nodes
README.md - Integration nodes → Cloud storage node: includes
README.md - Technical team → Agent orchestration: starts AI runs
- Agent orchestration → Agent runtime: streams run
packages/cli/src/modules/agents/agent-execution-orchestrator.service.ts - Agent orchestration → Agent runtime: gets runtime
packages/cli/src/modules/agents/agent-execution-orchestrator.service.ts - Agent runtime → Model handling: uses models
- Agent runtime → Agent tools: executes tools
- Agent runtime → Agent memory: uses memory
- Agent runtime → Agent streaming: emits stream
- Agent runtime → Code workspace: uses workspace
- Agent orchestration → Agent evaluations: evaluates runs
- Agent orchestration → Instance AI search: searches nodes
- Cloud storage node → Technical team: connects services
packages/nodes-base/nodes/Google/CloudStorage/GoogleCloudStorage.node.ts