How zeysun/antibmpnn works
AntiBMPNN is an antibody-sequence design system built around structure-conditioned ProteinMPNN. The main workflow takes an antibody variable-region PDB and design settings, generates candidate sequences, then parses and clusters the results for review and downstream structural validation. Helper scripts prepare optional design constraints; a separate training path builds and trains antibody models. The run script’s import of the model utilities and the training script’s model/data dependencies are supported by the source index. Some helper-script and example-script wiring is not shown, so those links are omitted or marked unverified.
Main entry points: Running_AntiBMPNN_run.py Design runner · parse_multiple_chains.py Parsed structure · Training.py Training workflow · make_fixed_positions_dict.py Position constraints
Components 20
Sequence design
- Design runner
Running_AntiBMPNN_run.py - ProteinMPNN utilities
protein_mpnn_utils.py - Parsed structure
helper_scripts/parse_multiple_chains.py
Design constraints
- Chain selection
helper_scripts/assign_fixed_chains.py - Position constraints
helper_scripts/make_fixed_positions_dict.py - Tied positions
helper_scripts/make_tied_positions_dict.py - Positive/negative ties
helper_scripts/make_pos_neg_tied_positions_dict.py - Amino-acid bias
helper_scripts/make_bias_AA.py - Residue bias
helper_scripts/make_bias_per_res_dict.py - PSSM constraints
helper_scripts/make_pssm_input_dict.py - Amino-acid omissions
helper_scripts/other_tools/make_omit_AA.py - PSSM conversion
helper_scripts/other_tools/make_pssm_dict.py
Result review
- Designed sequences
- Sequence analysis
helper_scripts/parsing_design_result.py
Model training
- Training workflow
training/Training.py - Training data utilities
training/utils_Antibody.py - Antibody model
training/model_utils_Antibody.py
Other components
- Designer
- Antibody PDB
- AlphaFold3
Connections 22
- Designer → Design runner: runs design
README.md - Antibody PDB → Design runner: supplies structure
README.md - Design runner → ProteinMPNN utilities: imports utilities
Running_AntiBMPNN_run.py - Design runner → Designed sequences: writes sequences
README.md - Designed sequences → Sequence analysis: parses and clusters
README.md - Sequence analysis → AlphaFold3: informs validation
README.md - Antibody PDB → Parsed structure: parses chains
- Parsed structure → Position constraints: supplies positions
- Parsed structure → Tied positions: supplies positions
- Parsed structure → Positive/negative ties: supplies positions
- Chain selection → Design runner: configures chains
- Position constraints → Design runner: configures positions
- Tied positions → Design runner: configures ties
- Positive/negative ties → Design runner: configures ties
- Amino-acid bias → Design runner: configures bias
- Residue bias → Design runner: configures bias
- PSSM constraints → Design runner: configures PSSM
- Amino-acid omissions → Design runner: configures omissions
- PSSM conversion → Design runner: prepares PSSM
- Training workflow → Training data utilities: uses data utilities
training/Training.py - Training workflow → Antibody model: constructs model
training/Training.py - Antibody model → Training workflow: returns model
training/Training.py