Awesome
ProteinGenerator: Generate sequence-structure pairs with RoseTTAFold
<img src='./utils/figs/seqdiff_anim_720p.gif' width='600' style="vertical-align:middle">Getting Started
The easiest way to get started is with PROTEIN GENERATOR a HuggingFace space where you can play around with the model!
And checkout the preprint now live on bioRxiv
Before running inference you will need to set up a custom conda environment.
Start by creating a new conda environment using the environment.yml file provided in the repository <code>conda env create -f environment.yml</code> and activating it <code>source activate proteingenerator</code>. Please make sure to modify the CUDA version and dgl version accordingly. Please refer to the dgl website for more information.
Once everything has been installed you can download checkpoints:
The easiest way to get started is opening the <code>protein_generator.ipynb</code> notebook and running the sampler class interactively, when ready to submit a production run use the output <code>agrs.json</code> file to launch:
<code>python ./inference.py -input_json ./examples/out/design_000000_args.json</code>
* note that to get the notebook running you will need to add the custom conda environment as a jupyter kernel, see how to do this here
Check out the templates in the example folder to see how you can set up jobs for the various design strategies
Adding new sequence based potentials
To add a custom potential to guide the sequence diffusion process toward your desired space, you can add potentials into <code>utils/potentials.py</code>. At the top of the file a template class is provided with functions that are required to implement your potential. It can be helpful to look through the other potentials in this file to see examples of how to implement. At the bottom of the file is a dictionary mapping the name used in the <code>potentials</code> argument to the class name in file.
About the model
ProteinGenerator is trained on the same dataset and uses the same architecture as RoseTTAFold. To train the model, a ground truth sequence is transformed into an Lx20 continuous space and gaussian noise is added to diffuse the sequence to the sampled timestep. To condition on structure and sequence, the structre for a motif is given and then corresponding sequence is denoised in the input. The rest of the structure is blackhole initialized. For each example the model is trained to predict Xo and losses are applied on the structure and sequence respectively. During training big T is set to 1000 steps, and a square root schedule is used to add noise.
Looking ahead
We are excited for the community to get involved writing new potentials and building out the codebase further!
Acknowledgements
We would like to thank Frank DiMaio and Minkyung Baek who developed RoseTTAFold which allowed us to build out this platform. Other acknowledgements for code and development please see the preprint.