PROTAC-Degradation-Predictor

A machine learning-based tool for predicting PROTAC protein degradation activity.

📚 Table of Contents

Data Curation
Installation
Usage
Training
Citation
License

📝 Data Curation

The code for data curation can be found in the Jupyter notebook data_curation.ipynb.

🚀 Installation

To install the package, open your terminal and run the following commands:

git clone https://github.com/ribesstefano/PROTAC-Degradation-Predictor.git
cd PROTAC-Degradation-Predictor
pip install .

The package has been developed on a Linux machine with Python 3.10.8. It is recommended to use a virtual environment to avoid conflicts with other packages.

🎯 Usage

For a thorough explanation on how to use the package, please refer to the tutorial notebook protac_degradation_predictor_tutorial.ipynb.

After installing the package, you can use it as follows:

import protac_degradation_predictor as pdp

protac_smiles = 'Cc1ncsc1-c1ccc(CNC(=O)[C@@H]2C[C@@H](O)CN2C(=O)[C@@H](NC(=O)COCCCCCCCCCOCC(=O)Nc2ccc(C(=O)Nc3ccc(F)cc3N)cc2)C(C)(C)C)cc1'
e3_ligase = 'VHL'
target_uniprot = 'P04637'
cell_line = 'HeLa'

active_protac = pdp.is_protac_active(
    protac_smiles,
    e3_ligase,
    target_uniprot,
    cell_line,
)

print(f'The given PROTAC is: {"active" if active_protac else "inactive"}')

This example demonstrates how to predict the activity of a PROTAC molecule. The is_protac_active function takes the SMILES string of the PROTAC, the E3 ligase, the UniProt ID of the target protein, and the cell line as inputs. It returns whether the PROTAC is active or not.

The function supports batch computation by passing lists of SMILES strings, E3 ligases, UniProt IDs, and cell lines. In this case, it returns a list of booleans indicating the activity of each PROTAC.

📈 Training

Before running the experiments, here are some required steps to follow (assuming one is in the repository directory already):

Download the data from the Cellosaurus database and save it in the data directory:

wget https://ftp.expasy.org/databases/cellosaurus/cellosaurus.txt data/

Make a copy of the Uniprot embeddings to be placed in the data directory:

cp protac_degradation_predictor/data/uniprot2embedding.h5 data/

Create a virtual environment and install the required packages by running the following commands:

conda env create -f environment.yaml
conda activate protac-degradation-predictor

The code for training the model can be found in the file run_experiments.py.

(Don't forget to adjust the PYTHONPATH environment variable to include the repository directory: export PYTHONPATH=$PYTHONPATH:/path/to/PROTAC-Degradation-Predictor)

📄 Citation

If you use this tool in your research, please cite the following paper:

@misc{ribes2024modeling,
    title={Modeling PROTAC Degradation Activity with Machine Learning},
    author={Stefano Ribes and Eva Nittinger and Christian Tyrchan and Rocío Mercado},
    year={2024},
    eprint={2406.02637},
    archivePrefix={arXiv},
    primaryClass={q-bio.QM}
}

📜 License

This project is licensed under the MIT License - see the LICENSE file for details.