# mwasifanwar/geneforge architecture

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

- Interactive diagram: https://gitdiagram.com/mwasifanwar/geneforge
- Repository: https://github.com/mwasifanwar/geneforge

## Overview

##### Project type and purpose
- This is a Python-based computational pipeline (“geneforge”) for designing novel protein structures.
- It exposes an API, processes input sequences/structures, applies transformer-based neural models, runs evolutionary algorithms, validates with molecular dynamics, predicts drug-discovery properties, and generates visualizations.

##### File structure
- Top level:
- main.py – orchestrator
- config.yaml – runtime/config parameters
- src/api/server.py – REST or RPC API entrypoint
- requirements.txt – dependencies
- src/data_processing – sequence/structure parsing and encoding
- src/neural_networks – transformer and property/structure predictors
- src/evolutionary – genetic algorithm, fitness functions, mutation operators
- src/molecular_dynamics – simulation driver, force‐field definitions, analysis
- src/drug_discovery – ADMET, binding‐affinity, docking predictors
- src/visualization – sequence and structure visualization
- src/utils – config loader, bioinformatics helper functions
- tests – unit tests for key modules

##### README insights
- “Transformer-based system that designs novel protein structures for drug discovery and synthetic biology using evolutionary algorithms and deep learning.”

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Client/API Layer
    Client["Client"]:::external
    APIServer["API Layer"]:::api
    click APIServer "https://github.com/mwasifanwar/geneforge/blob/main/src/api/server.py"

    %% Config Manager
    ConfigManager["Configuration Manager"]:::config
    click ConfigManager "https://github.com/mwasifanwar/geneforge/blob/main/config.yaml"
    click ConfigManager "https://github.com/mwasifanwar/geneforge/blob/main/src/utils/config.py"

    %% Orchestrator
    Orchestrator["Orchestrator (main.py)"]:::orchestrator
    click Orchestrator "https://github.com/mwasifanwar/geneforge/blob/main/main.py"

    %% Data Processing Module
    subgraph "Data Processing" 
        direction TB
        Parser["Protein Parser"]:::data
        Encoder["Sequence Encoder"]:::data
        StructProc["Structure Processor"]:::data
        click Parser "https://github.com/mwasifanwar/geneforge/blob/main/src/data_processing/protein_parser.py"
        click Encoder "https://github.com/mwasifanwar/geneforge/blob/main/src/data_processing/sequence_encoder.py"
        click StructProc "https://github.com/mwasifanwar/geneforge/blob/main/src/data_processing/structure_processor.py"
    end

    %% Neural Network Models
    subgraph "Neural Network Models"
        direction TB
        Transformer["Protein Transformer"]:::ml
        PropPred["Property Predictor"]:::ml
        StructPred["Structure Predictor"]:::ml
        click Transformer "https://github.com/mwasifanwar/geneforge/blob/main/src/neural_networks/protein_transformer.py"
        click PropPred "https://github.com/mwasifanwar/geneforge/blob/main/src/neural_networks/property_predictor.py"
        click StructPred "https://github.com/mwasifanwar/geneforge/blob/main/src/neural_networks/structure_predictor.py"
    end

    %% Evolutionary Engine
    subgraph "Evolutionary Engine"
        direction TB
        GA["Genetic Algorithm"]:::evolutionary
        Fitness["Fitness Functions"]:::evolutionary
        Mutation["Mutation Operators"]:::evolutionary
        click GA "https://github.com/mwasifanwar/geneforge/blob/main/src/evolutionary/genetic_algorithm.py"
        click Fitness "https://github.com/mwasifanwar/geneforge/blob/main/src/evolutionary/fitness_functions.py"
        click Mutation "https://github.com/mwasifanwar/geneforge/blob/main/src/evolutionary/mutation_operators.py"
    end

    %% Molecular Dynamics Simulator
    subgraph "Molecular Dynamics Simulator"
        direction TB
        Simulator["Simulator"]:::simulation
        ForceField["Force‐Field Definitions"]:::simulation
        MDAnalysis["Analysis"]:::simulation
        click Simulator "https://github.com/mwasifanwar/geneforge/blob/main/src/molecular_dynamics/simulator.py"
        click ForceField "https://github.com/mwasifanwar/geneforge/blob/main/src/molecular_dynamics/force_field.py"
        click MDAnalysis "https://github.com/mwasifanwar/geneforge/blob/main/src/molecular_dynamics/analysis.py"
    end

    %% Drug Discovery Predictors
    subgraph "Drug Discovery Predictors"
        direction TB
        ADMET["ADMET Predictor"]:::drug
        Binding["Binding Affinity"]:::drug
        Docking["Docking Predictor"]:::drug
        click ADMET "https://github.com/mwasifanwar/geneforge/blob/main/src/drug_discovery/admet_predictor.py"
        click Binding "https://github.com/mwasifanwar/geneforge/blob/main/src/drug_discovery/binding_affinity.py"
        click Docking "https://github.com/mwasifanwar/geneforge/blob/main/src/drug_discovery/docking_predictor.py"
    end

    %% Visualization Module
    subgraph "Visualization Module"
        direction TB
        SeqViz["Sequence Visualization"]:::viz
        StructViz["Structure Visualization"]:::viz
        click SeqViz "https://github.com/mwasifanwar/geneforge/blob/main/src/visualization/sequence_viz.py"
        click StructViz "https://github.com/mwasifanwar/geneforge/blob/main/src/visualization/structure_viz.py"
    end

    %% Data Storage and External Services
    Storage["Data Storage / Artifacts"]:::storage
    External["External Services"]:::external

    %% Data Flow
    Client -->|"submit sequence/design request"| APIServer
    APIServer -->|"invoke pipeline"| Orchestrator
    Orchestrator -->|"load parameters"| ConfigManager
    Orchestrator -->|"raw input → parsed/encoded"| Parser
    Parser --> Encoder
    Encoder --> StructProc
    StructProc --> Transformer
    Transformer --> PropPred
    StructProc --> StructPred
    Property_Output["Predicted Properties & Embeddings"]:::ml
    StructPred --> Property_Output
    PropPred --> Property_Output
    Property_Output --> Orchestrator
    Orchestrator -->|"initiate evolutionary loop"| GA
    GA --> Fitness
    GA --> Mutation
    GA --> Transformer
    GA --> Fitness
    GA --> Mutation
    GA -->|"candidate generation"| StructPred
    GA -->|"iterate: generate variants → evaluate fitness"| Property_Output
    GA -->|"candidate structures for validation"| Simulator
    Simulator --> MDAnalysis
    MDAnalysis --> Orchestrator
    Orchestrator -->|"evaluate ADMET/binding"| ADMET
    Orchestrator --> Binding
    Orchestrator --> Docking
    ADMET --> Storage
    Binding --> Storage
    Docking --> Storage
    Orchestrator --> SeqViz
    Orchestrator --> StructViz
    SeqViz --> Client
    StructViz --> Client
    Storage --> Client
    External --> Transformer
    External --> Simulator
    External --> Storage

    %% Styles
    classDef api fill:#a2d2ff,stroke:#1363df,color:#000
    classDef orchestrator fill:#ade8f4,stroke:#0096c7,color:#000
    classDef config fill:#ffecd1,stroke:#ffb703,color:#000
    classDef data fill:#caf0f8,stroke:#48cae4,color:#000
    classDef ml fill:#d8f3dc,stroke:#95d5b2,color:#000
    classDef evolutionary fill:#ffe5d9,stroke:#ff8fab,color:#000
    classDef simulation fill:#e0c3fc,stroke:#9d4edd,color:#000
    classDef drug fill:#ffd6e0,stroke:#f72585,color:#000
    classDef viz fill:#f0efeb,stroke:#a5a58d,color:#000
    classDef storage fill:#e2ece9,stroke:#2b2d42,color:#000
    classDef external fill:#f1faee,stroke:#457b9d,color:#000
```
