Sovereign 8s.is mirror of standardgalactic/Pred-MutPRI
  • Python 94.3%
  • Shell 5.7%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
2026-09-20 16:20:08 +08:00
alphafold3 Create README.md 2026-02-08 13:42:02 +08:00
Cytoscape Update README.md 2026-02-08 13:40:57 +08:00
Data Add files via upload 2026-08-21 12:21:13 +08:00
dssp Create README.md 2026-02-08 13:45:02 +08:00
FoldX Update FoldX installation instructions in README 2026-02-08 13:31:41 +08:00
ProtInter Create README.md 2026-02-08 13:37:33 +08:00
Scripts Add files via upload 2026-09-20 13:38:06 +08:00
x3dna-dssr Create README.md 2026-02-08 13:38:54 +08:00
CITATION.cff Add CITATION.cff for software citation metadata 2026-08-21 11:52:57 +08:00
LICENSE Add MIT License to the project 2026-08-21 11:51:25 +08:00
model.json Add files via upload 2026-08-21 11:48:14 +08:00
README.md Update README.md 2026-09-20 16:20:08 +08:00

This pipeline relies on several external tools. Please install/download them first and make sure they are available as described below.

FoldX

DSSP / mkdssp

ProtInter

DSSR (x3dna-dssr)

Cytoscape (for network features)

AlphaFold3 (for ES feature)

Environments

AlphaFold3 dependencies may conflict with ESM (and other Python packages used for prediction).
Therefore, we created two separate conda environments:

  • af3: used to ensure AlphaFold3 runs correctly (ES feature).
  • env1: the main prediction execution environment (feature extraction + XGBoost prediction, including ESM-related steps).

Python dependencies

Install the required Python packages in the env1 environment (example using pip):

pip install numpy pandas scikit-learn xgboost biopython
pip install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/cu118
pip install fair-esm
pip install py4cytoscape networkx

Notes:

  • The exact PyTorch command depends on your CUDA version (or use CPU-only wheels).
  • py4cytoscape requires Cytoscape to be running for the network feature step.

Run prediction

From the project root directory, run:

./predict.sh -PDB 1A1T -CHAIN A -Mut E21K --model_json model.json

Replace the arguments with your own inputs:

  • -PDB: PDB ID (e.g., 1A1T)
  • -CHAIN: chain ID (e.g., A)
  • -Mut: mutation in the format WT<pos>MUT (e.g., E21K)
  • --model_json: path to the trained XGBoost model file

Notes / Tips

  1. The input PDB file is recommended to be a protein–RNA dimer complex structure (i.e., the mutated protein chain and the RNA chain are both present in the same PDB file) to reduce potential issues during feature extraction.
  2. Because the pipeline integrates AlphaFold3, prediction may take a noticeable amount of time.
    For example, on a machine with 8 GB GPU memory (RTX 4060), a single prediction typically takes ~20 minutes on average.
  3. Software environment: Please use the software versions and runtime environment specified in this repository whenever possible. Differences in operating systems or versions of external dependencies (e.g., FoldX, Cytoscape/py4cytoscape, DSSP, ProtInter, AlphaFold3, and related Python packages) may lead to slight variations in intermediate features and final predictions.