# labring/fastgpt architecture

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

- Interactive diagram: https://gitdiagram.com/labring/fastgpt
- Repository: https://github.com/labring/fastgpt

## Overview

FastGPT is an AI-agent building platform: users configure applications and visual workflows, connect skills and knowledge sources, then run applications and inspect their results. Its documented capabilities span workflow orchestration, model calls, knowledge ingestion and retrieval, tool integrations, evaluation, and operational chat logs. The graph highlights those product stages and the Mongo/Redis service layer. README-described capabilities are included, but several connections are unverified because their implementation was not sampled; those edges are dashed rather than asserted as inspected call paths.

Main entry points: [`packages/global/core/workflow/runtime`](https://github.com/labring/fastgpt/tree/main/packages/global/core/workflow/runtime) (Workflow runtime), [`projects/app/src/pageComponents/app/detail/Edit/ChatAgent/hooks/useSkillManager.tsx`](https://github.com/labring/fastgpt/blob/main/projects/app/src/pageComponents/app/detail/Edit/ChatAgent/hooks/useSkillManager.tsx) (App editor), [`packages/service/common/mongo/index.ts`](https://github.com/labring/fastgpt/blob/main/packages/service/common/mongo/index.ts) (Mongo service), [`projects/app/src/pageComponents/app/detail/WorkflowComponents/Flow/nodes/NodeAgent/useAgentSkillManager.ts`](https://github.com/labring/fastgpt/blob/main/projects/app/src/pageComponents/app/detail/WorkflowComponents/Flow/nodes/NodeAgent/useAgentSkillManager.ts) (Workflow editor)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_authoring["Application authoring"]
  node_app_editor["App editor"]
  node_workflow_editor["Workflow editor"]
end

subgraph group_execution["AI execution"]
  node_workflow_runtime["Workflow runtime"]
  node_agent_skills["Agent skills"]
  node_tool_runtime["Tool runtime<br/>[runtime.ts]"]
  node_model_calls["Model calls"]
  node_chat_api["Chat API<br/>[api.ts]"]
end

subgraph group_knowledge["Knowledge base"]
  node_dataset_ingest["Dataset ingestion<br/>[utils.ts]"]
  node_dataset_search["Dataset search<br/>[utils.ts]"]
  node_api_dataset["API knowledge base<br/>[utils.ts]"]
end

subgraph group_operations["Evaluation and operations"]
  node_evaluation["App evaluation<br/>[api.ts]"]
  node_chat_logs["Chat logs<br/>[utils.ts]"]
  node_response_storage[("Node response storage")]
end

subgraph group_platform["Shared services"]
  node_permissions["Team permissions<br/>[controller.ts]"]
  node_mongo[("Mongo service<br/>[index.ts]")]
  node_redis_runtime[("Redis runtime<br/>[connection.ts]")]
  node_job_workers["Background workers<br/>[worker-manager.ts]"]
  node_skill_storage[("Skill package storage<br/>[storage.ts]")]
end

node_user(("User"))
node_external_models{{"Model providers"}}
node_external_tools{{"External tools"}}

node_user -->|"configures"| node_app_editor
node_app_editor -->|"selects skills"| node_workflow_editor
node_workflow_editor -.->|"defines flows"| node_workflow_runtime
node_workflow_runtime -.->|"dispatches skills"| node_agent_skills
node_workflow_runtime -.->|"runs tools"| node_tool_runtime
node_workflow_runtime -.->|"requests models"| node_model_calls
node_chat_api -.->|"starts flow"| node_workflow_runtime
node_model_calls -.->|"calls provider"| node_external_models
node_tool_runtime -.->|"invokes tools"| node_external_tools
node_dataset_ingest -.->|"stores records"| node_mongo
node_dataset_search -.->|"supplies retrieval"| node_workflow_runtime
node_api_dataset -.->|"exposes search"| node_dataset_search
node_user -->|"evaluates app"| node_evaluation
node_user -->|"reviews conversations"| node_chat_logs
node_chat_logs -.->|"records responses"| node_response_storage
node_response_storage -.->|"persists rows"| node_mongo
node_app_editor -.->|"uses access roles"| node_permissions
node_job_workers -->|"creates connections"| node_redis_runtime
node_agent_skills -.->|"stores packages"| node_skill_storage
node_skill_storage -->|"reads metadata"| node_mongo

click node_app_editor "https://github.com/labring/fastgpt/blob/main/projects/app/src/pageComponents/app/detail/Edit/ChatAgent/hooks/useSkillManager.tsx"
click node_workflow_editor "https://github.com/labring/fastgpt/blob/main/projects/app/src/pageComponents/app/detail/WorkflowComponents/Flow/nodes/NodeAgent/useAgentSkillManager.ts"
click node_workflow_runtime "https://github.com/labring/fastgpt/tree/main/packages/global/core/workflow/runtime"
click node_agent_skills "https://github.com/labring/fastgpt/tree/main/packages/global/core/ai/skill"
click node_tool_runtime "https://github.com/labring/fastgpt/blob/main/packages/global/core/app/tool/runtime.ts"
click node_model_calls "https://github.com/labring/fastgpt/tree/main/packages/global/core/ai/llm"
click node_chat_api "https://github.com/labring/fastgpt/blob/main/packages/global/openapi/core/chat/completion/api.ts"
click node_dataset_ingest "https://github.com/labring/fastgpt/blob/main/packages/global/core/dataset/training/utils.ts"
click node_dataset_search "https://github.com/labring/fastgpt/blob/main/packages/global/core/dataset/search/utils.ts"
click node_api_dataset "https://github.com/labring/fastgpt/blob/main/packages/global/core/dataset/apiDataset/utils.ts"
click node_evaluation "https://github.com/labring/fastgpt/blob/main/packages/global/core/app/evaluation/api.ts"
click node_chat_logs "https://github.com/labring/fastgpt/blob/main/packages/global/core/app/logs/utils.ts"
click node_response_storage "https://github.com/labring/fastgpt/blob/main/packages/service/core/chat/nodeResponseStorage.ts"
click node_permissions "https://github.com/labring/fastgpt/blob/main/packages/global/support/permission/user/controller.ts"
click node_mongo "https://github.com/labring/fastgpt/blob/main/packages/service/common/mongo/index.ts"
click node_redis_runtime "https://github.com/labring/fastgpt/blob/main/packages/dal/redis/runtime/connection.ts"
click node_job_workers "https://github.com/labring/fastgpt/blob/main/packages/dal/redis/bullmq/worker-manager.ts"
click node_skill_storage "https://github.com/labring/fastgpt/blob/main/packages/service/core/ai/skill/package/storage.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_app_editor,node_workflow_editor,node_user toneBlue
class node_workflow_runtime,node_agent_skills,node_tool_runtime,node_model_calls,node_chat_api toneAmber
class node_dataset_ingest,node_dataset_search,node_api_dataset toneMint
class node_evaluation,node_chat_logs,node_response_storage toneRose
class node_permissions,node_mongo,node_redis_runtime,node_job_workers,node_skill_storage,node_external_models,node_external_tools toneIndigo
```

## Components

### Application authoring

- [App editor](https://github.com/labring/fastgpt/blob/main/projects/app/src/pageComponents/app/detail/Edit/ChatAgent/hooks/useSkillManager.tsx): `projects/app/src/pageComponents/app/detail/Edit/ChatAgent/hooks/useSkillManager.tsx`
- [Workflow editor](https://github.com/labring/fastgpt/blob/main/projects/app/src/pageComponents/app/detail/WorkflowComponents/Flow/nodes/NodeAgent/useAgentSkillManager.ts): `projects/app/src/pageComponents/app/detail/WorkflowComponents/Flow/nodes/NodeAgent/useAgentSkillManager.ts`

### AI execution

- [Workflow runtime](https://github.com/labring/fastgpt/tree/main/packages/global/core/workflow/runtime): `packages/global/core/workflow/runtime`
- [Agent skills](https://github.com/labring/fastgpt/tree/main/packages/global/core/ai/skill): `packages/global/core/ai/skill`
- [Tool runtime](https://github.com/labring/fastgpt/blob/main/packages/global/core/app/tool/runtime.ts): `packages/global/core/app/tool/runtime.ts`
- [Model calls](https://github.com/labring/fastgpt/tree/main/packages/global/core/ai/llm): `packages/global/core/ai/llm`
- [Chat API](https://github.com/labring/fastgpt/blob/main/packages/global/openapi/core/chat/completion/api.ts): `packages/global/openapi/core/chat/completion/api.ts`

### Knowledge base

- [Dataset ingestion](https://github.com/labring/fastgpt/blob/main/packages/global/core/dataset/training/utils.ts): `packages/global/core/dataset/training/utils.ts`
- [Dataset search](https://github.com/labring/fastgpt/blob/main/packages/global/core/dataset/search/utils.ts): `packages/global/core/dataset/search/utils.ts`
- [API knowledge base](https://github.com/labring/fastgpt/blob/main/packages/global/core/dataset/apiDataset/utils.ts): `packages/global/core/dataset/apiDataset/utils.ts`

### Evaluation and operations

- [App evaluation](https://github.com/labring/fastgpt/blob/main/packages/global/core/app/evaluation/api.ts): `packages/global/core/app/evaluation/api.ts`
- [Chat logs](https://github.com/labring/fastgpt/blob/main/packages/global/core/app/logs/utils.ts): `packages/global/core/app/logs/utils.ts`
- [Node response storage](https://github.com/labring/fastgpt/blob/main/packages/service/core/chat/nodeResponseStorage.ts): `packages/service/core/chat/nodeResponseStorage.ts`

### Shared services

- [Team permissions](https://github.com/labring/fastgpt/blob/main/packages/global/support/permission/user/controller.ts): `packages/global/support/permission/user/controller.ts`
- [Mongo service](https://github.com/labring/fastgpt/blob/main/packages/service/common/mongo/index.ts): `packages/service/common/mongo/index.ts`
- [Redis runtime](https://github.com/labring/fastgpt/blob/main/packages/dal/redis/runtime/connection.ts): `packages/dal/redis/runtime/connection.ts`
- [Background workers](https://github.com/labring/fastgpt/blob/main/packages/dal/redis/bullmq/worker-manager.ts): `packages/dal/redis/bullmq/worker-manager.ts`
- [Skill package storage](https://github.com/labring/fastgpt/blob/main/packages/service/core/ai/skill/package/storage.ts): `packages/service/core/ai/skill/package/storage.ts`

### Other components

- **User**
- **Model providers**
- **External tools**

## Connections

- User → App editor: configures (evidence: `README.md`)
- App editor → Workflow editor: selects skills (evidence: `projects/app/src/pageComponents/app/detail/WorkflowComponents/Flow/nodes/NodeAgent/useAgentSkillManager.ts`)
- Workflow editor → Workflow runtime: defines flows
- Workflow runtime → Agent skills: dispatches skills
- Workflow runtime → Tool runtime: runs tools
- Workflow runtime → Model calls: requests models
- Chat API → Workflow runtime: starts flow
- Model calls → Model providers: calls provider
- Tool runtime → External tools: invokes tools
- Dataset ingestion → Mongo service: stores records
- Dataset search → Workflow runtime: supplies retrieval
- API knowledge base → Dataset search: exposes search
- User → App evaluation: evaluates app (evidence: `README.md`)
- User → Chat logs: reviews conversations (evidence: `README.md`)
- Chat logs → Node response storage: records responses
- Node response storage → Mongo service: persists rows (evidence: `packages/service/core/chat/nodeResponseStorage.ts`)
- App editor → Team permissions: uses access roles
- Background workers → Redis runtime: creates connections (evidence: `packages/dal/redis/bullmq/worker-manager.ts`)
- Agent skills → Skill package storage: stores packages
- Skill package storage → Mongo service: reads metadata (evidence: `packages/service/core/ai/skill/package/storage.ts`)
