# optimized-brain/mutaion architecture

> Architecture diagram of the GitHub repository optimized-brain/mutaion, 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/optimized-brain/mutaion
- Repository: https://github.com/optimized-brain/mutaion

## Overview

MutAIon is a web app for exploring genome assemblies, genes and sequences, then predicting SNV effects with Evo2 and comparing predictions with ClinVar classifications. The documented user journey runs from assembly selection and gene browsing to sequence inspection, variant analysis and comparison. The sampled frontend shows gene-viewer orchestration and API-helper calls; README statements support the broader frontend/backend and Evo2/ClinVar capabilities. Backend internals and genome-data provider wiring were not sampled, so those connections are documented or left unverified rather than inferred.

Main entry points: [`frontend/src/components/gene-viewer.tsx`](https://github.com/optimized-brain/mutaion/blob/main/frontend/src/components/gene-viewer.tsx) (Gene viewer), [`frontend/src/components/known-variants.tsx`](https://github.com/optimized-brain/mutaion/blob/main/frontend/src/components/known-variants.tsx) (Known variants), [`frontend/src/components/variant-analysis.tsx`](https://github.com/optimized-brain/mutaion/blob/main/frontend/src/components/variant-analysis.tsx) (Variant analysis), [`frontend/src/components/variant-comparison-modal.tsx`](https://github.com/optimized-brain/mutaion/blob/main/frontend/src/components/variant-comparison-modal.tsx) (Result comparison)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Genome exploration"]
  node_webapp["Next.js app"]
  node_assembly_gene_browse["Assembly and gene browsing<br/>[page.tsx]"]
  node_gene_viewer["Gene viewer<br/>[gene-viewer.tsx]"]
  node_gene_sequence["Sequence browser<br/>[gene-sequence.tsx]"]
  node_gene_information["Gene information"]
  node_genome_api["Genome API helpers<br/>[genome-api.ts]"]
end

subgraph group_analysis["Variant analysis"]
  node_known_variants["Known variants<br/>[known-variants.tsx]"]
  node_variant_analysis["Variant analysis"]
  node_comparison_modal["Result comparison"]
  node_coloring_utils["Result formatting<br/>[coloring-utils.ts]"]
  node_clinvar[("ClinVar data")]
end

subgraph group_backend["Prediction service"]
  node_backend_service["Prediction API<br/>[main.py]"]
  node_evo2["Evo2 model"]
end

subgraph group_ui["UI building blocks"]
  node_button["Button<br/>[button.tsx]"]
  node_card["Card<br/>[card.tsx]"]
  node_input["Input<br/>[input.tsx]"]
  node_table["Table<br/>[table.tsx]"]
end

node_user(("Researcher"))

node_user -->|"uses"| node_webapp
node_webapp -.->|"presents"| node_assembly_gene_browse
node_assembly_gene_browse -.->|"opens gene"| node_gene_viewer
node_gene_viewer -->|"fetches gene data"| node_genome_api
node_gene_viewer -->|"renders"| node_gene_sequence
node_gene_viewer -->|"renders"| node_gene_information
node_gene_viewer -->|"renders"| node_known_variants
node_gene_viewer -->|"renders"| node_variant_analysis
node_gene_viewer -->|"renders"| node_comparison_modal
node_known_variants -->|"requests predictions"| node_genome_api
node_variant_analysis -->|"requests prediction"| node_genome_api
node_known_variants -->|"shows classifications"| node_clinvar
node_comparison_modal -->|"compares classifications"| node_clinvar
node_genome_api -->|"calls endpoint"| node_backend_service
node_backend_service -->|"predicts with"| node_evo2
node_backend_service -.->|"fetches classifications"| node_clinvar
node_gene_sequence -->|"uses"| node_card
node_gene_viewer -->|"uses"| node_button
node_gene_information -->|"uses"| node_card
node_known_variants -->|"uses"| node_table
node_known_variants -->|"uses"| node_card
node_variant_analysis -->|"uses"| node_card
node_variant_analysis -->|"uses"| node_button
node_variant_analysis -.->|"uses"| node_input
node_comparison_modal -->|"uses"| node_button
node_known_variants -->|"formats results"| node_coloring_utils
node_variant_analysis -->|"formats results"| node_coloring_utils
node_comparison_modal -->|"formats results"| node_coloring_utils

click node_webapp "https://github.com/optimized-brain/mutaion/tree/main/frontend/src/app"
click node_assembly_gene_browse "https://github.com/optimized-brain/mutaion/blob/main/frontend/src/app/page.tsx"
click node_gene_viewer "https://github.com/optimized-brain/mutaion/blob/main/frontend/src/components/gene-viewer.tsx"
click node_gene_sequence "https://github.com/optimized-brain/mutaion/blob/main/frontend/src/components/gene-sequence.tsx"
click node_gene_information "https://github.com/optimized-brain/mutaion/blob/main/frontend/src/components/gene-information.tsx"
click node_genome_api "https://github.com/optimized-brain/mutaion/blob/main/frontend/src/utils/genome-api.ts"
click node_known_variants "https://github.com/optimized-brain/mutaion/blob/main/frontend/src/components/known-variants.tsx"
click node_variant_analysis "https://github.com/optimized-brain/mutaion/blob/main/frontend/src/components/variant-analysis.tsx"
click node_comparison_modal "https://github.com/optimized-brain/mutaion/blob/main/frontend/src/components/variant-comparison-modal.tsx"
click node_coloring_utils "https://github.com/optimized-brain/mutaion/blob/main/frontend/src/utils/coloring-utils.ts"
click node_backend_service "https://github.com/optimized-brain/mutaion/blob/main/backend/main.py"
click node_evo2 "https://github.com/optimized-brain/mutaion/tree/main/backend/evo2"
click node_button "https://github.com/optimized-brain/mutaion/blob/main/frontend/src/components/ui/button.tsx"
click node_card "https://github.com/optimized-brain/mutaion/blob/main/frontend/src/components/ui/card.tsx"
click node_input "https://github.com/optimized-brain/mutaion/blob/main/frontend/src/components/ui/input.tsx"
click node_table "https://github.com/optimized-brain/mutaion/blob/main/frontend/src/components/ui/table.tsx"

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_webapp,node_assembly_gene_browse,node_gene_viewer,node_gene_sequence,node_gene_information,node_genome_api toneBlue
class node_known_variants,node_variant_analysis,node_comparison_modal,node_coloring_utils,node_clinvar toneAmber
class node_backend_service,node_evo2 toneMint
class node_button,node_card,node_input,node_table toneRose
class node_user toneIndigo
```

## Components

### Genome exploration

- [Next.js app](https://github.com/optimized-brain/mutaion/tree/main/frontend/src/app): `frontend/src/app`
- [Assembly and gene browsing](https://github.com/optimized-brain/mutaion/blob/main/frontend/src/app/page.tsx): `frontend/src/app/page.tsx`
- [Gene viewer](https://github.com/optimized-brain/mutaion/blob/main/frontend/src/components/gene-viewer.tsx): `frontend/src/components/gene-viewer.tsx`
- [Sequence browser](https://github.com/optimized-brain/mutaion/blob/main/frontend/src/components/gene-sequence.tsx): `frontend/src/components/gene-sequence.tsx`
- [Gene information](https://github.com/optimized-brain/mutaion/blob/main/frontend/src/components/gene-information.tsx): `frontend/src/components/gene-information.tsx`
- [Genome API helpers](https://github.com/optimized-brain/mutaion/blob/main/frontend/src/utils/genome-api.ts): `frontend/src/utils/genome-api.ts`

### Variant analysis

- [Known variants](https://github.com/optimized-brain/mutaion/blob/main/frontend/src/components/known-variants.tsx): `frontend/src/components/known-variants.tsx`
- [Variant analysis](https://github.com/optimized-brain/mutaion/blob/main/frontend/src/components/variant-analysis.tsx): `frontend/src/components/variant-analysis.tsx`
- [Result comparison](https://github.com/optimized-brain/mutaion/blob/main/frontend/src/components/variant-comparison-modal.tsx): `frontend/src/components/variant-comparison-modal.tsx`
- [Result formatting](https://github.com/optimized-brain/mutaion/blob/main/frontend/src/utils/coloring-utils.ts): `frontend/src/utils/coloring-utils.ts`
- **ClinVar data**

### Prediction service

- [Prediction API](https://github.com/optimized-brain/mutaion/blob/main/backend/main.py): `backend/main.py`
- [Evo2 model](https://github.com/optimized-brain/mutaion/tree/main/backend/evo2): `backend/evo2`

### UI building blocks

- [Button](https://github.com/optimized-brain/mutaion/blob/main/frontend/src/components/ui/button.tsx): `frontend/src/components/ui/button.tsx`
- [Card](https://github.com/optimized-brain/mutaion/blob/main/frontend/src/components/ui/card.tsx): `frontend/src/components/ui/card.tsx`
- [Input](https://github.com/optimized-brain/mutaion/blob/main/frontend/src/components/ui/input.tsx): `frontend/src/components/ui/input.tsx`
- [Table](https://github.com/optimized-brain/mutaion/blob/main/frontend/src/components/ui/table.tsx): `frontend/src/components/ui/table.tsx`

### Other components

- **Researcher**

## Connections

- Researcher → Next.js app: uses (evidence: `README.md`)
- Next.js app → Assembly and gene browsing: presents
- Assembly and gene browsing → Gene viewer: opens gene
- Gene viewer → Genome API helpers: fetches gene data (evidence: `frontend/src/components/gene-viewer.tsx`)
- Gene viewer → Sequence browser: renders (evidence: `frontend/src/components/gene-viewer.tsx`)
- Gene viewer → Gene information: renders (evidence: `frontend/src/components/gene-viewer.tsx`)
- Gene viewer → Known variants: renders (evidence: `frontend/src/components/gene-viewer.tsx`)
- Gene viewer → Variant analysis: renders (evidence: `frontend/src/components/gene-viewer.tsx`)
- Gene viewer → Result comparison: renders (evidence: `frontend/src/components/gene-viewer.tsx`)
- Known variants → Genome API helpers: requests predictions (evidence: `frontend/src/components/known-variants.tsx`)
- Variant analysis → Genome API helpers: requests prediction (evidence: `frontend/src/components/variant-analysis.tsx`)
- Known variants → ClinVar data: shows classifications (evidence: `README.md`)
- Result comparison → ClinVar data: compares classifications (evidence: `README.md`)
- Genome API helpers → Prediction API: calls endpoint (evidence: `README.md`)
- Prediction API → Evo2 model: predicts with (evidence: `README.md`)
- Prediction API → ClinVar data: fetches classifications (evidence: `README.md`)
- Sequence browser → Card: uses (evidence: `frontend/src/components/gene-sequence.tsx`)
- Gene viewer → Button: uses (evidence: `frontend/src/components/gene-viewer.tsx`)
- Gene information → Card: uses (evidence: `frontend/src/components/gene-information.tsx`)
- Known variants → Table: uses (evidence: `frontend/src/components/known-variants.tsx`)
- Known variants → Card: uses (evidence: `frontend/src/components/known-variants.tsx`)
- Variant analysis → Card: uses (evidence: `frontend/src/components/variant-analysis.tsx`)
- Variant analysis → Button: uses (evidence: `frontend/src/components/variant-analysis.tsx`)
- Variant analysis → Input: uses (evidence: `frontend/src/components/variant-analysis.tsx`)
- Result comparison → Button: uses (evidence: `frontend/src/components/variant-comparison-modal.tsx`)
- Known variants → Result formatting: formats results (evidence: `frontend/src/components/known-variants.tsx`)
- Variant analysis → Result formatting: formats results (evidence: `frontend/src/components/variant-analysis.tsx`)
- Result comparison → Result formatting: formats results (evidence: `frontend/src/components/variant-comparison-modal.tsx`)
