# aadisrimenon/protmind-ai_3step architecture

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

- Interactive diagram: https://gitdiagram.com/aadisrimenon/protmind-ai_3step
- Repository: https://github.com/aadisrimenon/protmind-ai_3step

## Overview

ProtMind AI is a Streamlit prototype for entering a protein sequence and mutation, retrieving protein metadata and a predicted structure, then extracting mutation features and an alignment score. The implemented workflow passes input through Streamlit session state; page modules call parsing, retrieval, and analysis functions in the shared backend. The README also describes Pfam, STRING, stability, structure validation, pathogenicity, and reporting capabilities, but these are not implemented in the sampled source; they are shown as documented extensions, not verified runtime stages.

Main entry points: [`pages/1_User_Input.py`](https://github.com/aadisrimenon/protmind-ai_3step/blob/main/pages/1_User_Input.py) (Input page), [`app.py`](https://github.com/aadisrimenon/protmind-ai_3step/blob/main/app.py) (Session payload), [`pages/2_Data_Retrieval.py`](https://github.com/aadisrimenon/protmind-ai_3step/blob/main/pages/2_Data_Retrieval.py) (Retrieval page), [`pages/3_Preprocessing.py`](https://github.com/aadisrimenon/protmind-ai_3step/blob/main/pages/3_Preprocessing.py) (Preprocessing page)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_workflow["Streamlit workflow"]
  node_dashboard["Dashboard<br/>[app.py]"]
  node_input_page["Input page<br/>[1_User_Input.py]"]
  node_payload["Session payload<br/>[app.py]"]
  node_retrieval_page["Retrieval page"]
  node_preprocessing_page["Preprocessing page<br/>[3_Preprocessing.py]"]
end

subgraph group_backend["Shared backend"]
  node_validation["Input validation<br/>[backend.py]"]
  node_fasta["FASTA parsing<br/>[backend.py]"]
  node_feature_analysis["Mutation features<br/>[backend.py]"]
  node_alignment["Sequence alignment<br/>[backend.py]"]
  node_uniprot_fetch["UniProt retrieval<br/>[backend.py]"]
  node_alphafold_fetch["AlphaFold lookup<br/>[backend.py]"]
end

subgraph group_extensions["Documented extensions"]
  node_pfam["Pfam domains"]
  node_string["STRING networks"]
  node_stability["Stability analysis"]
  node_validation_ext["Structure validation"]
  node_pathogenicity["Pathogenicity scoring"]
  node_reporting["Integrated reports"]
end

node_user(("Researcher"))
node_uniprot_api["UniProt API"]
node_alphafold_api["AlphaFold DB API"]

node_user -->|"enters sequence"| node_input_page
node_dashboard -->|"initializes state"| node_payload
node_input_page -->|"parses sequence"| node_fasta
node_input_page -->|"validates fields"| node_validation
node_input_page -->|"saves input"| node_payload
node_payload -->|"supplies input"| node_retrieval_page
node_payload -->|"supplies input"| node_preprocessing_page
node_retrieval_page -->|"requests metadata"| node_uniprot_fetch
node_retrieval_page -->|"requests structure"| node_alphafold_fetch
node_uniprot_fetch -->|"queries"| node_uniprot_api
node_alphafold_fetch -->|"queries"| node_alphafold_api
node_preprocessing_page -->|"extracts features"| node_feature_analysis
node_preprocessing_page -->|"scores alignment"| node_alignment
node_pfam -.-> node_user
node_string -.-> node_user
node_stability -.-> node_user
node_validation_ext -.-> node_user
node_pathogenicity -.-> node_user
node_reporting -.-> node_user

click node_dashboard "https://github.com/aadisrimenon/protmind-ai_3step/blob/main/app.py"
click node_input_page "https://github.com/aadisrimenon/protmind-ai_3step/blob/main/pages/1_User_Input.py"
click node_payload "https://github.com/aadisrimenon/protmind-ai_3step/blob/main/app.py"
click node_retrieval_page "https://github.com/aadisrimenon/protmind-ai_3step/blob/main/pages/2_Data_Retrieval.py"
click node_preprocessing_page "https://github.com/aadisrimenon/protmind-ai_3step/blob/main/pages/3_Preprocessing.py"
click node_validation "https://github.com/aadisrimenon/protmind-ai_3step/blob/main/backend.py"
click node_fasta "https://github.com/aadisrimenon/protmind-ai_3step/blob/main/backend.py"
click node_feature_analysis "https://github.com/aadisrimenon/protmind-ai_3step/blob/main/backend.py"
click node_alignment "https://github.com/aadisrimenon/protmind-ai_3step/blob/main/backend.py"
click node_uniprot_fetch "https://github.com/aadisrimenon/protmind-ai_3step/blob/main/backend.py"
click node_alphafold_fetch "https://github.com/aadisrimenon/protmind-ai_3step/blob/main/backend.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_dashboard,node_input_page,node_payload,node_retrieval_page,node_preprocessing_page toneBlue
class node_validation,node_fasta,node_feature_analysis,node_alignment,node_uniprot_fetch,node_alphafold_fetch toneAmber
class node_pfam,node_string,node_stability,node_validation_ext,node_pathogenicity,node_reporting,node_uniprot_api,node_alphafold_api toneMint
class node_user toneIndigo
```

## Components

### Streamlit workflow

- [Dashboard](https://github.com/aadisrimenon/protmind-ai_3step/blob/main/app.py): `app.py`
- [Input page](https://github.com/aadisrimenon/protmind-ai_3step/blob/main/pages/1_User_Input.py): `pages/1_User_Input.py`
- [Session payload](https://github.com/aadisrimenon/protmind-ai_3step/blob/main/app.py): `app.py`
- [Retrieval page](https://github.com/aadisrimenon/protmind-ai_3step/blob/main/pages/2_Data_Retrieval.py): `pages/2_Data_Retrieval.py`
- [Preprocessing page](https://github.com/aadisrimenon/protmind-ai_3step/blob/main/pages/3_Preprocessing.py): `pages/3_Preprocessing.py`

### Shared backend

- [Input validation](https://github.com/aadisrimenon/protmind-ai_3step/blob/main/backend.py): `backend.py`
- [FASTA parsing](https://github.com/aadisrimenon/protmind-ai_3step/blob/main/backend.py): `backend.py`
- [Mutation features](https://github.com/aadisrimenon/protmind-ai_3step/blob/main/backend.py): `backend.py`
- [Sequence alignment](https://github.com/aadisrimenon/protmind-ai_3step/blob/main/backend.py): `backend.py`
- [UniProt retrieval](https://github.com/aadisrimenon/protmind-ai_3step/blob/main/backend.py): `backend.py`
- [AlphaFold lookup](https://github.com/aadisrimenon/protmind-ai_3step/blob/main/backend.py): `backend.py`

### Documented extensions

- **Pfam domains**
- **STRING networks**
- **Stability analysis**
- **Structure validation**
- **Pathogenicity scoring**
- **Integrated reports**

### Other components

- **Researcher**
- **UniProt API**
- **AlphaFold DB API**

## Connections

- Researcher → Input page: enters sequence (evidence: `pages/1_User_Input.py`)
- Dashboard → Session payload: initializes state (evidence: `app.py`)
- Input page → FASTA parsing: parses sequence (evidence: `pages/1_User_Input.py`)
- Input page → Input validation: validates fields (evidence: `pages/1_User_Input.py`)
- Input page → Session payload: saves input (evidence: `pages/1_User_Input.py`)
- Session payload → Retrieval page: supplies input (evidence: `pages/2_Data_Retrieval.py`)
- Session payload → Preprocessing page: supplies input (evidence: `pages/3_Preprocessing.py`)
- Retrieval page → UniProt retrieval: requests metadata (evidence: `pages/2_Data_Retrieval.py`)
- Retrieval page → AlphaFold lookup: requests structure (evidence: `pages/2_Data_Retrieval.py`)
- UniProt retrieval → UniProt API: queries (evidence: `backend.py`)
- AlphaFold lookup → AlphaFold DB API: queries (evidence: `backend.py`)
- Preprocessing page → Mutation features: extracts features (evidence: `pages/3_Preprocessing.py`)
- Preprocessing page → Sequence alignment: scores alignment (evidence: `pages/3_Preprocessing.py`)
- Pfam domains → Researcher (evidence: `README.md`)
- STRING networks → Researcher (evidence: `README.md`)
- Stability analysis → Researcher (evidence: `README.md`)
- Structure validation → Researcher (evidence: `README.md`)
- Pathogenicity scoring → Researcher (evidence: `README.md`)
- Integrated reports → Researcher (evidence: `README.md`)
