# googlecloudplatform/lifesciences architecture

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

- Interactive diagram: https://gitdiagram.com/googlecloudplatform/lifesciences
- Repository: https://github.com/googlecloudplatform/lifesciences

## Overview

This repository is a collection of pharma and life-sciences demos, not one integrated product. Its principal workflows are application-specific: users submit protein predictions through FoldRun, manage drug-discovery programs with DDE, or provide media for Sentinel’s compliance review. The graph preserves these distinct products and documented capabilities rather than implying they form a shared pipeline. Some subsystems are represented by directory paths because their source was not sampled; connections are limited to README statements and indexed or excerpted references.

Main entry points: [`applications/drug-design-engine/tools/dde/commands/program.py`](https://github.com/googlecloudplatform/lifesciences/blob/main/applications/drug-design-engine/tools/dde/commands/program.py) (Program Orchestration), [`applications/sentinel/frontend/src/App.tsx`](https://github.com/googlecloudplatform/lifesciences/blob/main/applications/sentinel/frontend/src/App.tsx) (Review Interface), [`applications/foldrun/foldrun-agent/foldrun_app/models/af2/pipeline/pipelines/alphafold_inference_pipeline.py`](https://github.com/googlecloudplatform/lifesciences/blob/main/applications/foldrun/foldrun-agent/foldrun_app/models/af2/pipeline/pipelines/alphafold_inference_pipeline.py) (AlphaFold Pipeline), [`applications/foldrun/foldrun-agent/foldrun_app/app_utils/reasoning_engine_adapter.py`](https://github.com/googlecloudplatform/lifesciences/blob/main/applications/foldrun/foldrun-agent/foldrun_app/app_utils/reasoning_engine_adapter.py) (Reasoning API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_dde["Drug Design Engine"]
  node_dde_program["Program Orchestration<br/>[program.py]"]
  node_dde_concepts["Program Concepts<br/>[concepts.py]"]
  node_dde_control[("Program State<br/>[controlstore.py]")]
  node_dde_policy["Policy Rules<br/>[policy.py]"]
  node_dde_provenance["Evidence Provenance<br/>[provenance.py]"]
  node_dde_thresholds["Decision Thresholds<br/>[thresholds.py]"]
end

subgraph group_foldrun["Protein Prediction"]
  node_foldrun_agent["Agent Interface<br/>[agent.py]"]
  node_foldrun_adapter["Reasoning API"]
  node_af2_pipeline["AlphaFold Pipeline"]
  node_af2_configure["Run Configuration<br/>[configure_run.py]"]
  node_af2_data["Sequence Features<br/>[data_pipeline.py]"]
  node_boltz_msa["Boltz2 MSA<br/>[msa_pipeline.py]"]
  node_of3_pipeline["OpenFold3 Pipeline"]
  node_foldrun_viewer["Structure Viewer<br/>[app.py]"]
end

subgraph group_sentinel["Compliance Review"]
  node_sentinel_ui["Review Interface<br/>[App.tsx]"]
  node_sentinel_results["Results Panel<br/>[ResultsPanel.tsx]"]
  node_sentinel_client["API Client<br/>[client.ts]"]
  node_sentinel_api["API Service<br/>[main.py]"]
  node_sentinel_gemini["Gemini Analysis<br/>[gemini_client.py]"]
  node_sentinel_storage["Media Storage Routes<br/>[storage.py]"]
end

subgraph group_gemini["Gemini Agents"]
  node_argus_agent["Argus Agent<br/>[agent.py]"]
end

node_user(("User"))
node_gcs[("Google Cloud Storage")]

node_user -->|"manages programs"| node_dde_program
node_dde_program -->|"uses concepts"| node_dde_concepts
node_dde_program -->|"uses state store"| node_dde_control
node_user -.->|"requests prediction"| node_foldrun_adapter
node_foldrun_adapter -->|"dispatches requests"| node_foldrun_agent
node_af2_pipeline -->|"uses configuration"| node_af2_configure
node_af2_pipeline -->|"runs feature stage"| node_af2_data
node_af2_data -.->|"shares model capability"| node_boltz_msa
node_user -.->|"submits media"| node_sentinel_ui
node_sentinel_ui -->|"renders results"| node_sentinel_results
node_sentinel_ui -->|"uses API client"| node_sentinel_client
node_sentinel_api -->|"imports analysis service"| node_sentinel_gemini
node_sentinel_storage -->|"streams and stores media"| node_gcs
node_user -.->|"uses pharma agent"| node_argus_agent

click node_dde_program "https://github.com/googlecloudplatform/lifesciences/blob/main/applications/drug-design-engine/tools/dde/commands/program.py"
click node_dde_concepts "https://github.com/googlecloudplatform/lifesciences/blob/main/applications/drug-design-engine/tools/dde/core/concepts.py"
click node_dde_control "https://github.com/googlecloudplatform/lifesciences/blob/main/applications/drug-design-engine/tools/dde/core/controlstore.py"
click node_dde_policy "https://github.com/googlecloudplatform/lifesciences/blob/main/applications/drug-design-engine/tools/dde/core/policy.py"
click node_dde_provenance "https://github.com/googlecloudplatform/lifesciences/blob/main/applications/drug-design-engine/tools/dde/core/provenance.py"
click node_dde_thresholds "https://github.com/googlecloudplatform/lifesciences/blob/main/applications/drug-design-engine/tools/dde/core/thresholds.py"
click node_foldrun_agent "https://github.com/googlecloudplatform/lifesciences/blob/main/applications/foldrun/foldrun-agent/foldrun_app/agent.py"
click node_foldrun_adapter "https://github.com/googlecloudplatform/lifesciences/blob/main/applications/foldrun/foldrun-agent/foldrun_app/app_utils/reasoning_engine_adapter.py"
click node_af2_pipeline "https://github.com/googlecloudplatform/lifesciences/blob/main/applications/foldrun/foldrun-agent/foldrun_app/models/af2/pipeline/pipelines/alphafold_inference_pipeline.py"
click node_af2_configure "https://github.com/googlecloudplatform/lifesciences/blob/main/applications/foldrun/foldrun-agent/foldrun_app/models/af2/pipeline/components/configure_run.py"
click node_af2_data "https://github.com/googlecloudplatform/lifesciences/blob/main/applications/foldrun/foldrun-agent/foldrun_app/models/af2/pipeline/components/data_pipeline.py"
click node_boltz_msa "https://github.com/googlecloudplatform/lifesciences/blob/main/applications/foldrun/foldrun-agent/foldrun_app/models/boltz2/pipeline/components/msa_pipeline.py"
click node_of3_pipeline "https://github.com/googlecloudplatform/lifesciences/blob/main/applications/foldrun/foldrun-agent/foldrun_app/models/of3/pipeline/pipelines/of3_inference_pipeline.py"
click node_foldrun_viewer "https://github.com/googlecloudplatform/lifesciences/blob/main/applications/foldrun/src/foldrun-viewer/app.py"
click node_sentinel_ui "https://github.com/googlecloudplatform/lifesciences/blob/main/applications/sentinel/frontend/src/App.tsx"
click node_sentinel_results "https://github.com/googlecloudplatform/lifesciences/blob/main/applications/sentinel/frontend/src/components/ResultsPanel.tsx"
click node_sentinel_client "https://github.com/googlecloudplatform/lifesciences/blob/main/applications/sentinel/frontend/src/api/client.ts"
click node_sentinel_api "https://github.com/googlecloudplatform/lifesciences/blob/main/applications/sentinel/api/main.py"
click node_sentinel_gemini "https://github.com/googlecloudplatform/lifesciences/blob/main/applications/sentinel/api/services/gemini_client.py"
click node_sentinel_storage "https://github.com/googlecloudplatform/lifesciences/blob/main/applications/sentinel/api/routes/storage.py"
click node_argus_agent "https://github.com/googlecloudplatform/lifesciences/blob/main/applications/pharma-on-gemini-enterprise/argus-on-gemini-enterprise/app/agent.py"

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_dde_program,node_dde_concepts,node_dde_control,node_dde_policy,node_dde_provenance,node_dde_thresholds,node_user toneBlue
class node_foldrun_agent,node_foldrun_adapter,node_af2_pipeline,node_af2_configure,node_af2_data,node_boltz_msa,node_of3_pipeline,node_foldrun_viewer,node_gcs toneAmber
class node_sentinel_ui,node_sentinel_results,node_sentinel_client,node_sentinel_api,node_sentinel_gemini,node_sentinel_storage toneMint
class node_argus_agent toneRose
```

## Components

### Drug Design Engine

- [Program Orchestration](https://github.com/googlecloudplatform/lifesciences/blob/main/applications/drug-design-engine/tools/dde/commands/program.py): `applications/drug-design-engine/tools/dde/commands/program.py`
- [Program Concepts](https://github.com/googlecloudplatform/lifesciences/blob/main/applications/drug-design-engine/tools/dde/core/concepts.py): `applications/drug-design-engine/tools/dde/core/concepts.py`
- [Program State](https://github.com/googlecloudplatform/lifesciences/blob/main/applications/drug-design-engine/tools/dde/core/controlstore.py): `applications/drug-design-engine/tools/dde/core/controlstore.py`
- [Policy Rules](https://github.com/googlecloudplatform/lifesciences/blob/main/applications/drug-design-engine/tools/dde/core/policy.py): `applications/drug-design-engine/tools/dde/core/policy.py`
- [Evidence Provenance](https://github.com/googlecloudplatform/lifesciences/blob/main/applications/drug-design-engine/tools/dde/core/provenance.py): `applications/drug-design-engine/tools/dde/core/provenance.py`
- [Decision Thresholds](https://github.com/googlecloudplatform/lifesciences/blob/main/applications/drug-design-engine/tools/dde/core/thresholds.py): `applications/drug-design-engine/tools/dde/core/thresholds.py`

### Protein Prediction

- [Agent Interface](https://github.com/googlecloudplatform/lifesciences/blob/main/applications/foldrun/foldrun-agent/foldrun_app/agent.py): `applications/foldrun/foldrun-agent/foldrun_app/agent.py`
- [Reasoning API](https://github.com/googlecloudplatform/lifesciences/blob/main/applications/foldrun/foldrun-agent/foldrun_app/app_utils/reasoning_engine_adapter.py): `applications/foldrun/foldrun-agent/foldrun_app/app_utils/reasoning_engine_adapter.py`
- [AlphaFold Pipeline](https://github.com/googlecloudplatform/lifesciences/blob/main/applications/foldrun/foldrun-agent/foldrun_app/models/af2/pipeline/pipelines/alphafold_inference_pipeline.py): `applications/foldrun/foldrun-agent/foldrun_app/models/af2/pipeline/pipelines/alphafold_inference_pipeline.py`
- [Run Configuration](https://github.com/googlecloudplatform/lifesciences/blob/main/applications/foldrun/foldrun-agent/foldrun_app/models/af2/pipeline/components/configure_run.py): `applications/foldrun/foldrun-agent/foldrun_app/models/af2/pipeline/components/configure_run.py`
- [Sequence Features](https://github.com/googlecloudplatform/lifesciences/blob/main/applications/foldrun/foldrun-agent/foldrun_app/models/af2/pipeline/components/data_pipeline.py): `applications/foldrun/foldrun-agent/foldrun_app/models/af2/pipeline/components/data_pipeline.py`
- [Boltz2 MSA](https://github.com/googlecloudplatform/lifesciences/blob/main/applications/foldrun/foldrun-agent/foldrun_app/models/boltz2/pipeline/components/msa_pipeline.py): `applications/foldrun/foldrun-agent/foldrun_app/models/boltz2/pipeline/components/msa_pipeline.py`
- [OpenFold3 Pipeline](https://github.com/googlecloudplatform/lifesciences/blob/main/applications/foldrun/foldrun-agent/foldrun_app/models/of3/pipeline/pipelines/of3_inference_pipeline.py): `applications/foldrun/foldrun-agent/foldrun_app/models/of3/pipeline/pipelines/of3_inference_pipeline.py`
- [Structure Viewer](https://github.com/googlecloudplatform/lifesciences/blob/main/applications/foldrun/src/foldrun-viewer/app.py): `applications/foldrun/src/foldrun-viewer/app.py`

### Compliance Review

- [Review Interface](https://github.com/googlecloudplatform/lifesciences/blob/main/applications/sentinel/frontend/src/App.tsx): `applications/sentinel/frontend/src/App.tsx`
- [Results Panel](https://github.com/googlecloudplatform/lifesciences/blob/main/applications/sentinel/frontend/src/components/ResultsPanel.tsx): `applications/sentinel/frontend/src/components/ResultsPanel.tsx`
- [API Client](https://github.com/googlecloudplatform/lifesciences/blob/main/applications/sentinel/frontend/src/api/client.ts): `applications/sentinel/frontend/src/api/client.ts`
- [API Service](https://github.com/googlecloudplatform/lifesciences/blob/main/applications/sentinel/api/main.py): `applications/sentinel/api/main.py`
- [Gemini Analysis](https://github.com/googlecloudplatform/lifesciences/blob/main/applications/sentinel/api/services/gemini_client.py): `applications/sentinel/api/services/gemini_client.py`
- [Media Storage Routes](https://github.com/googlecloudplatform/lifesciences/blob/main/applications/sentinel/api/routes/storage.py): `applications/sentinel/api/routes/storage.py`

### Gemini Agents

- [Argus Agent](https://github.com/googlecloudplatform/lifesciences/blob/main/applications/pharma-on-gemini-enterprise/argus-on-gemini-enterprise/app/agent.py): `applications/pharma-on-gemini-enterprise/argus-on-gemini-enterprise/app/agent.py`

### Other components

- **User**
- **Google Cloud Storage**

## Connections

- User → Program Orchestration: manages programs
- Program Orchestration → Program Concepts: uses concepts (evidence: `applications/drug-design-engine/tools/dde/commands/program.py`)
- Program Orchestration → Program State: uses state store (evidence: `applications/drug-design-engine/tools/dde/commands/program.py`)
- User → Reasoning API: requests prediction
- Reasoning API → Agent Interface: dispatches requests (evidence: `applications/foldrun/foldrun-agent/foldrun_app/app_utils/reasoning_engine_adapter.py`)
- AlphaFold Pipeline → Run Configuration: uses configuration (evidence: `applications/foldrun/foldrun-agent/foldrun_app/models/af2/pipeline/pipelines/alphafold_inference_pipeline.py`)
- AlphaFold Pipeline → Sequence Features: runs feature stage (evidence: `applications/foldrun/foldrun-agent/foldrun_app/models/af2/pipeline/pipelines/alphafold_inference_pipeline.py`)
- Sequence Features → Boltz2 MSA: shares model capability
- User → Review Interface: submits media
- Review Interface → Results Panel: renders results (evidence: `applications/sentinel/frontend/src/App.tsx`)
- Review Interface → API Client: uses API client (evidence: `applications/sentinel/frontend/src/App.tsx`)
- API Service → Gemini Analysis: imports analysis service (evidence: `applications/sentinel/api/main.py`)
- Media Storage Routes → Google Cloud Storage: streams and stores media (evidence: `applications/sentinel/api/routes/storage.py`)
- User → Argus Agent: uses pharma agent
