# flowiseai/flowise architecture

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

- Interactive diagram: https://gitdiagram.com/flowiseai/flowise
- Repository: https://github.com/flowiseai/flowise

## Overview

Flowise is a visual AI-agent and LLM application builder. Users author flows in the browser, configure nodes and connections, then use the resulting agents and integrations; the repository also includes execution observation and enterprise account/workspace capabilities. The README documents the product modules, while sampled source confirms Agentflow state/validation and UI input composition. Several runtime handoffs and unsampled feature internals are therefore omitted or shown only as unverified dashed links.

Main entry points: [`packages/agentflow/src/features/canvas`](https://github.com/flowiseai/flowise/tree/main/packages/agentflow/src/features/canvas) (Flow canvas), [`packages/components/nodes/engine`](https://github.com/flowiseai/flowise/tree/main/packages/components/nodes/engine) (Query engines), [`packages/ui/src/App.jsx`](https://github.com/flowiseai/flowise/blob/main/packages/ui/src/App.jsx) (Web UI), [`packages/components/nodes`](https://github.com/flowiseai/flowise/tree/main/packages/components/nodes) (Model and tool nodes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_author["Flow Authoring"]
  node_ui["Web UI<br/>[App.jsx]"]
  node_canvas["Flow canvas"]
  node_editor["Node editor"]
  node_palette["Node palette"]
  node_inputs["Input controls"]
  node_flowstate["Flow state"]
  node_validation["Flow validation"]
  node_generator["Flow generator"]
end

subgraph group_runtime["Agent Runtime"]
  node_server["API server<br/>[Interface.ts]"]
  node_queue["Execution queues<br/>[QueueManager.ts]"]
  node_agentnodes["Agentflow nodes"]
  node_integrations["Model and tool nodes"]
  node_engines["Query engines"]
  node_evaluation["Evaluation tracing"]
end

subgraph group_observe["Execution Observation"]
  node_observeui["Execution viewer"]
  node_observeapi["Observation API client<br/>[client.ts]"]
end

subgraph group_platform["Server Platform"]
  node_identity["Identity manager<br/>[IdentityManager.ts]"]
  node_billing["Subscription and quotas<br/>[StripeManager.ts]"]
  node_usagecache[("Usage cache")]
end

subgraph group_enterprise["Enterprise Access"]
  node_workspace["Workspace management"]
  node_roles[("Organization roles<br/>[role.entity.ts]")]
end

node_user(("Flow builder"))
node_externalmodels{{"AI model services"}}
node_externaldata{{"Data and tool services"}}

node_user -.->|"opens"| node_ui
node_ui -.->|"authors flows"| node_canvas
node_canvas -.->|"edits nodes"| node_editor
node_canvas -.->|"adds nodes"| node_palette
node_editor -.->|"renders controls"| node_inputs
node_inputs -.->|"updates state"| node_flowstate
node_canvas -.->|"handles flow state"| node_flowstate
node_flowstate -->|"validates via"| node_validation
node_user -.->|"requests flow"| node_generator
node_ui -.->|"uses API"| node_server
node_server -.->|"dispatches work"| node_queue
node_queue -.->|"runs flows"| node_agentnodes
node_agentnodes -.->|"uses components"| node_integrations
node_integrations -.->|"calls models"| node_externalmodels
node_integrations -.->|"connects services"| node_externaldata
node_engines -.->|"queries models"| node_externalmodels
node_engines -.->|"retrieves data"| node_externaldata
node_engines -->|"injects evaluation metadata"| node_evaluation
node_user -.->|"inspects runs"| node_observeui
node_observeui -.->|"loads execution data"| node_observeapi
node_identity -.->|"verifies license"| node_externalmodels
node_billing -->|"reads quotas"| node_usagecache
node_workspace -->|"uses role records"| node_roles
node_workspace -.->|"checks plan features"| node_identity

click node_ui "https://github.com/flowiseai/flowise/blob/main/packages/ui/src/App.jsx"
click node_canvas "https://github.com/flowiseai/flowise/tree/main/packages/agentflow/src/features/canvas"
click node_editor "https://github.com/flowiseai/flowise/tree/main/packages/agentflow/src/features/node-editor"
click node_palette "https://github.com/flowiseai/flowise/tree/main/packages/agentflow/src/features/node-palette"
click node_inputs "https://github.com/flowiseai/flowise/blob/main/packages/agentflow/src/atoms/NodeInputHandler.tsx"
click node_flowstate "https://github.com/flowiseai/flowise/blob/main/packages/agentflow/src/infrastructure/store/agentflowReducer.ts"
click node_validation "https://github.com/flowiseai/flowise/tree/main/packages/agentflow/src/core/validation"
click node_generator "https://github.com/flowiseai/flowise/tree/main/packages/agentflow/src/features/generator"
click node_server "https://github.com/flowiseai/flowise/blob/main/packages/server/src/Interface.ts"
click node_queue "https://github.com/flowiseai/flowise/blob/main/packages/server/src/queue/QueueManager.ts"
click node_agentnodes "https://github.com/flowiseai/flowise/tree/main/packages/components/nodes/agentflow"
click node_integrations "https://github.com/flowiseai/flowise/tree/main/packages/components/nodes"
click node_engines "https://github.com/flowiseai/flowise/tree/main/packages/components/nodes/engine"
click node_evaluation "https://github.com/flowiseai/flowise/blob/main/packages/components/evaluation/EvaluationRunTracerLlama.ts"
click node_observeui "https://github.com/flowiseai/flowise/tree/main/packages/observe/src/features/executions"
click node_observeapi "https://github.com/flowiseai/flowise/blob/main/packages/observe/src/infrastructure/api/client.ts"
click node_identity "https://github.com/flowiseai/flowise/blob/main/packages/server/src/IdentityManager.ts"
click node_billing "https://github.com/flowiseai/flowise/blob/main/packages/server/src/StripeManager.ts"
click node_usagecache "https://github.com/flowiseai/flowise/blob/main/packages/server/src/UsageCacheManager.ts"
click node_workspace "https://github.com/flowiseai/flowise/blob/main/packages/server/src/enterprise/controllers/workspace.controller.ts"
click node_roles "https://github.com/flowiseai/flowise/blob/main/packages/server/src/enterprise/database/entities/role.entity.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_ui,node_canvas,node_editor,node_palette,node_inputs,node_flowstate,node_validation,node_generator toneBlue
class node_server,node_queue,node_agentnodes,node_integrations,node_engines,node_evaluation toneAmber
class node_observeui,node_observeapi toneMint
class node_identity,node_billing,node_usagecache toneRose
class node_workspace,node_roles,node_user,node_externalmodels,node_externaldata toneIndigo
```

## Components

### Flow Authoring

- [Web UI](https://github.com/flowiseai/flowise/blob/main/packages/ui/src/App.jsx): `packages/ui/src/App.jsx`
- [Flow canvas](https://github.com/flowiseai/flowise/tree/main/packages/agentflow/src/features/canvas): `packages/agentflow/src/features/canvas`
- [Node editor](https://github.com/flowiseai/flowise/tree/main/packages/agentflow/src/features/node-editor): `packages/agentflow/src/features/node-editor`
- [Node palette](https://github.com/flowiseai/flowise/tree/main/packages/agentflow/src/features/node-palette): `packages/agentflow/src/features/node-palette`
- [Input controls](https://github.com/flowiseai/flowise/blob/main/packages/agentflow/src/atoms/NodeInputHandler.tsx): `packages/agentflow/src/atoms/NodeInputHandler.tsx`
- [Flow state](https://github.com/flowiseai/flowise/blob/main/packages/agentflow/src/infrastructure/store/agentflowReducer.ts): `packages/agentflow/src/infrastructure/store/agentflowReducer.ts`
- [Flow validation](https://github.com/flowiseai/flowise/tree/main/packages/agentflow/src/core/validation): `packages/agentflow/src/core/validation`
- [Flow generator](https://github.com/flowiseai/flowise/tree/main/packages/agentflow/src/features/generator): `packages/agentflow/src/features/generator`

### Agent Runtime

- [API server](https://github.com/flowiseai/flowise/blob/main/packages/server/src/Interface.ts): `packages/server/src/Interface.ts`
- [Execution queues](https://github.com/flowiseai/flowise/blob/main/packages/server/src/queue/QueueManager.ts): `packages/server/src/queue/QueueManager.ts`
- [Agentflow nodes](https://github.com/flowiseai/flowise/tree/main/packages/components/nodes/agentflow): `packages/components/nodes/agentflow`
- [Model and tool nodes](https://github.com/flowiseai/flowise/tree/main/packages/components/nodes): `packages/components/nodes`
- [Query engines](https://github.com/flowiseai/flowise/tree/main/packages/components/nodes/engine): `packages/components/nodes/engine`
- [Evaluation tracing](https://github.com/flowiseai/flowise/blob/main/packages/components/evaluation/EvaluationRunTracerLlama.ts): `packages/components/evaluation/EvaluationRunTracerLlama.ts`

### Execution Observation

- [Execution viewer](https://github.com/flowiseai/flowise/tree/main/packages/observe/src/features/executions): `packages/observe/src/features/executions`
- [Observation API client](https://github.com/flowiseai/flowise/blob/main/packages/observe/src/infrastructure/api/client.ts): `packages/observe/src/infrastructure/api/client.ts`

### Server Platform

- [Identity manager](https://github.com/flowiseai/flowise/blob/main/packages/server/src/IdentityManager.ts): `packages/server/src/IdentityManager.ts`
- [Subscription and quotas](https://github.com/flowiseai/flowise/blob/main/packages/server/src/StripeManager.ts): `packages/server/src/StripeManager.ts`
- [Usage cache](https://github.com/flowiseai/flowise/blob/main/packages/server/src/UsageCacheManager.ts): `packages/server/src/UsageCacheManager.ts`

### Enterprise Access

- [Workspace management](https://github.com/flowiseai/flowise/blob/main/packages/server/src/enterprise/controllers/workspace.controller.ts): `packages/server/src/enterprise/controllers/workspace.controller.ts`
- [Organization roles](https://github.com/flowiseai/flowise/blob/main/packages/server/src/enterprise/database/entities/role.entity.ts): `packages/server/src/enterprise/database/entities/role.entity.ts`

### Other components

- **Flow builder**
- **AI model services**
- **Data and tool services**

## Connections

- Flow builder → Web UI: opens
- Web UI → Flow canvas: authors flows
- Flow canvas → Node editor: edits nodes
- Flow canvas → Node palette: adds nodes
- Node editor → Input controls: renders controls
- Input controls → Flow state: updates state
- Flow canvas → Flow state: handles flow state
- Flow state → Flow validation: validates via
- Flow builder → Flow generator: requests flow
- Web UI → API server: uses API
- API server → Execution queues: dispatches work (evidence: `packages/server/src/queue/QueueManager.ts`)
- Execution queues → Agentflow nodes: runs flows
- Agentflow nodes → Model and tool nodes: uses components
- Model and tool nodes → AI model services: calls models
- Model and tool nodes → Data and tool services: connects services
- Query engines → AI model services: queries models
- Query engines → Data and tool services: retrieves data
- Query engines → Evaluation tracing: injects evaluation metadata (evidence: `packages/components/nodes/engine/SubQuestionQueryEngine/SubQuestionQueryEngine.ts`)
- Flow builder → Execution viewer: inspects runs
- Execution viewer → Observation API client: loads execution data
- Identity manager → AI model services: verifies license
- Subscription and quotas → Usage cache: reads quotas (evidence: `packages/server/src/StripeManager.ts`)
- Workspace management → Organization roles: uses role records (evidence: `packages/server/src/enterprise/controllers/workspace.controller.ts`)
- Workspace management → Identity manager: checks plan features
