# ugeneunipro/ugene architecture

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

- Interactive diagram: https://gitdiagram.com/ugeneunipro/ugene
- Repository: https://github.com/ugeneunipro/ugene

## Overview

UGENE is an integrated bioinformatics application, with graphical and command-line entry points and a broad set of sequence-analysis capabilities. Its visible product areas include workflow authoring and execution, query design, algorithm services, biological data handling, and cloud storage. The principal user-facing path is workflow authoring: users assemble and configure workflows, which can then be loaded or run; workflow data is managed through UGENE’s data-storage layer. The excerpts show only part of this architecture, so unsampled algorithm links and runtime dispatches are not asserted.

Main entry points: [`src/plugins/workflow_designer/src/WorkflowViewController.cpp`](https://github.com/ugeneunipro/ugene/blob/master/src/plugins/workflow_designer/src/WorkflowViewController.cpp) (Workflow editor), [`src/ugeneui/src/workspace/CloudStorageService.cpp`](https://github.com/ugeneunipro/ugene/blob/master/src/ugeneui/src/workspace/CloudStorageService.cpp) (Cloud storage service), [`src/corelibs/U2Lang/src/model/DbiDataStorage.cpp`](https://github.com/ugeneunipro/ugene/blob/master/src/corelibs/U2Lang/src/model/DbiDataStorage.cpp) (Workflow data storage), [`src/ugeneui/src/workspace/CloudStorageDockWidget.cpp`](https://github.com/ugeneunipro/ugene/blob/master/src/ugeneui/src/workspace/CloudStorageDockWidget.cpp) (Cloud storage panel)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Application entry points"]
  node_gui["Desktop application"]
  node_cli["Command-line app<br/>[Main.cpp]"]
end

subgraph group_workflow["Workflow design"]
  node_workflow_editor["Workflow editor"]
  node_workflow_coverage["Coverage worker"]
  node_query["Query designer"]
  node_datasets["Dataset inputs"]
end

subgraph group_bio["Bioinformatics tools"]
  node_algorithms["Analysis algorithms"]
end

subgraph group_data["Data and storage"]
  node_sequence_data["Sequence data types"]
  node_workflow_storage["Workflow data storage<br/>[DbiDataStorage.cpp]"]
  node_file_storage[("Application file storage<br/>[AppFileStorage.cpp]")]
  node_cleanup["Storage cleanup task"]
end

subgraph group_cloud["Cloud storage"]
  node_cloud_ui["Cloud storage panel"]
  node_cloud_service["Cloud storage service"]
  node_workspace_service["Workspace service<br/>[WorkspaceService.h]"]
  node_websocket["WebSocket service"]
end

node_user(("UGENE user"))
node_cloud_backend{{"Cloud backend"}}

node_user -.->|"authors workflows"| node_workflow_editor
node_user -.->|"designs queries"| node_query
node_workflow_editor -->|"configures inputs"| node_datasets
node_workflow_editor -.->|"uses worker"| node_workflow_coverage
node_workflow_editor -.->|"uses storage"| node_workflow_storage
node_cli -.->|"registers calculators"| node_algorithms
node_workflow_storage -->|"stores objects"| node_sequence_data
node_cleanup -.->|"cleans files"| node_file_storage
node_gui -.->|"opens panel"| node_cloud_ui
node_cloud_ui -->|"requests operations"| node_cloud_service
node_cloud_service -->|"sends API requests"| node_workspace_service
node_cloud_service -->|"subscribes to events"| node_websocket
node_workspace_service -.->|"communicates with"| node_cloud_backend

click node_gui "https://github.com/ugeneunipro/ugene/tree/master/src/ugeneui/src"
click node_cli "https://github.com/ugeneunipro/ugene/blob/master/src/ugenecl/src/Main.cpp"
click node_workflow_editor "https://github.com/ugeneunipro/ugene/blob/master/src/plugins/workflow_designer/src/WorkflowViewController.cpp"
click node_workflow_coverage "https://github.com/ugeneunipro/ugene/blob/master/src/plugins/workflow_designer/src/library/ExtractAssemblyCoverageWorker.cpp"
click node_query "https://github.com/ugeneunipro/ugene/blob/master/src/plugins/query_designer/src/QueryViewController.cpp"
click node_datasets "https://github.com/ugeneunipro/ugene/blob/master/src/corelibs/U2Designer/src/DatasetsController.cpp"
click node_algorithms "https://github.com/ugeneunipro/ugene/tree/master/src/corelibs/U2Algorithm/src"
click node_sequence_data "https://github.com/ugeneunipro/ugene/tree/master/src/corelibs/U2Core/src/datatype"
click node_workflow_storage "https://github.com/ugeneunipro/ugene/blob/master/src/corelibs/U2Lang/src/model/DbiDataStorage.cpp"
click node_file_storage "https://github.com/ugeneunipro/ugene/blob/master/src/corelibs/U2Core/src/globals/AppFileStorage.cpp"
click node_cleanup "https://github.com/ugeneunipro/ugene/blob/master/src/corelibs/U2Core/src/tasks/CleanupFileStorageTask.cpp"
click node_cloud_ui "https://github.com/ugeneunipro/ugene/blob/master/src/ugeneui/src/workspace/CloudStorageDockWidget.cpp"
click node_cloud_service "https://github.com/ugeneunipro/ugene/blob/master/src/ugeneui/src/workspace/CloudStorageService.cpp"
click node_workspace_service "https://github.com/ugeneunipro/ugene/blob/master/src/ugeneui/src/workspace/WorkspaceService.h"
click node_websocket "https://github.com/ugeneunipro/ugene/tree/master/src/ugeneui/src/workspace"

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_gui,node_cli,node_user toneBlue
class node_workflow_editor,node_workflow_coverage,node_query,node_datasets toneAmber
class node_algorithms toneMint
class node_sequence_data,node_workflow_storage,node_file_storage,node_cleanup toneRose
class node_cloud_ui,node_cloud_service,node_workspace_service,node_websocket,node_cloud_backend toneIndigo
```

## Components

### Application entry points

- [Desktop application](https://github.com/ugeneunipro/ugene/tree/master/src/ugeneui/src): `src/ugeneui/src`
- [Command-line app](https://github.com/ugeneunipro/ugene/blob/master/src/ugenecl/src/Main.cpp): `src/ugenecl/src/Main.cpp`

### Workflow design

- [Workflow editor](https://github.com/ugeneunipro/ugene/blob/master/src/plugins/workflow_designer/src/WorkflowViewController.cpp): `src/plugins/workflow_designer/src/WorkflowViewController.cpp`
- [Coverage worker](https://github.com/ugeneunipro/ugene/blob/master/src/plugins/workflow_designer/src/library/ExtractAssemblyCoverageWorker.cpp): `src/plugins/workflow_designer/src/library/ExtractAssemblyCoverageWorker.cpp`
- [Query designer](https://github.com/ugeneunipro/ugene/blob/master/src/plugins/query_designer/src/QueryViewController.cpp): `src/plugins/query_designer/src/QueryViewController.cpp`
- [Dataset inputs](https://github.com/ugeneunipro/ugene/blob/master/src/corelibs/U2Designer/src/DatasetsController.cpp): `src/corelibs/U2Designer/src/DatasetsController.cpp`

### Bioinformatics tools

- [Analysis algorithms](https://github.com/ugeneunipro/ugene/tree/master/src/corelibs/U2Algorithm/src): `src/corelibs/U2Algorithm/src`

### Data and storage

- [Sequence data types](https://github.com/ugeneunipro/ugene/tree/master/src/corelibs/U2Core/src/datatype): `src/corelibs/U2Core/src/datatype`
- [Workflow data storage](https://github.com/ugeneunipro/ugene/blob/master/src/corelibs/U2Lang/src/model/DbiDataStorage.cpp): `src/corelibs/U2Lang/src/model/DbiDataStorage.cpp`
- [Application file storage](https://github.com/ugeneunipro/ugene/blob/master/src/corelibs/U2Core/src/globals/AppFileStorage.cpp): `src/corelibs/U2Core/src/globals/AppFileStorage.cpp`
- [Storage cleanup task](https://github.com/ugeneunipro/ugene/blob/master/src/corelibs/U2Core/src/tasks/CleanupFileStorageTask.cpp): `src/corelibs/U2Core/src/tasks/CleanupFileStorageTask.cpp`

### Cloud storage

- [Cloud storage panel](https://github.com/ugeneunipro/ugene/blob/master/src/ugeneui/src/workspace/CloudStorageDockWidget.cpp): `src/ugeneui/src/workspace/CloudStorageDockWidget.cpp`
- [Cloud storage service](https://github.com/ugeneunipro/ugene/blob/master/src/ugeneui/src/workspace/CloudStorageService.cpp): `src/ugeneui/src/workspace/CloudStorageService.cpp`
- [Workspace service](https://github.com/ugeneunipro/ugene/blob/master/src/ugeneui/src/workspace/WorkspaceService.h): `src/ugeneui/src/workspace/WorkspaceService.h`
- [WebSocket service](https://github.com/ugeneunipro/ugene/tree/master/src/ugeneui/src/workspace): `src/ugeneui/src/workspace`

### Other components

- **UGENE user**
- **Cloud backend**

## Connections

- UGENE user → Workflow editor: authors workflows
- UGENE user → Query designer: designs queries
- Workflow editor → Dataset inputs: configures inputs (evidence: `src/plugins/workflow_designer/src/WorkflowViewController.cpp`)
- Workflow editor → Coverage worker: uses worker
- Workflow editor → Workflow data storage: uses storage
- Command-line app → Analysis algorithms: registers calculators
- Workflow data storage → Sequence data types: stores objects (evidence: `src/corelibs/U2Lang/src/model/DbiDataStorage.cpp`)
- Storage cleanup task → Application file storage: cleans files
- Desktop application → Cloud storage panel: opens panel (evidence: `src/ugeneui/src/workspace/CloudStorageDockWidget.cpp`)
- Cloud storage panel → Cloud storage service: requests operations (evidence: `src/ugeneui/src/workspace/CloudStorageDockWidget.cpp`)
- Cloud storage service → Workspace service: sends API requests (evidence: `src/ugeneui/src/workspace/CloudStorageService.cpp`)
- Cloud storage service → WebSocket service: subscribes to events (evidence: `src/ugeneui/src/workspace/CloudStorageService.cpp`)
- Workspace service → Cloud backend: communicates with
