REvoDesign 0.0.0rc23.post1

A PyMOL plugin that makes enzyme redesign tasks easier to all.

REvoDesign

---

Platforms supported

CI Status

Docker images

Code checkings

---

Introduction

Welcome to REvoDesign - a PyMOL plugin that makes enzyme redesign tasks easier for everyone. REvoDesign aims at facilitating enzyme redesign using a combination of structural and phylogenetic information, serving as a co-pilot for protein designers and leveraging the wealth of human knowledge in enzyme design.

About the Plugin

Enzyme redesign is a complex task that requires a deep understanding of protein structures, substrate binding sites, and evolutionary relationships. REvoDesign Toolkit is designed to streamline this process by offering a range of tools and functionalities to assist protein designers in their endeavors.

---

Basic Architecture Design

Key Features

In brief, the REvoDesign PyMOL plugin provides a set of essential tools to help protein designers with the following tasks:

1. Surface Residue Analysis: Identify surface residues exposed as solvent-accessible surface area (SASA) and design pocket identification based on substrates and/or cofactors, with customizable cutoffs.

2. Mutant Loading: Load available designable mutants through a PSSM-like table in CSV format, allowing for customizable rejections and preferences.

3. Human Knowledge Supervision: Perform human knowledge-supervised mutant selection within the PyMOL interface, utilizing structural views.

4. Scale Reduction: Reduce the scale of your design, making it suitable for low-throughput wet-lab validation by leveraging sequence clustering.

5. Visualization: Visualize mutant tables in PyMOL, whether they have been scored or not.

6. Co-Evolution Analysis: Search for possible inter-residue co-evolved residue pairs for effective mutants using the GREMLIN Markov random field profile.

REvoDesign is your indispensable companion in the intricate journey of enzyme redesign. Whether you are a seasoned protein designer or just beginning your exploration, REvoDesign Toolkit is here to simplify your workflow and enhance your enzyme engineering endeavors.

Please refer to the documentation(WIP) for detailed instructions on how to use the toolkit and make the most of its features.

---

Dependencies wait list

[!NOTE] These are the dependencies that are not yet implemented but will be added in the toolkit.

Designers

• SaProt
• Prime
• ProtSSN
• Native Pythia-ddG
• CarbonDesign
• ProtMamba
• LigandMPNN
• UniKP
• ByProt

Sidechain Solvers

• AttnPacker
• opus_rota4
• GeoPacker

---

Installation

REvoDesign offers a user-friendly installation process using a graphical user interface (GUI).

Step 1: Install the REvoDesign Package Manager

Before installing the main program, you need to install the REvoDesign Package Manager as a PyMOL plugin.

1. Open PyMOL.

2. Navigate to Plugin > Plugin Manager and select Install New Plugin.

3. Choose Install from PyMOLWiki or any URL.

4. Paste the following URL:

   https://gist.githubusercontent.com/YaoYinYing/c1e8bfe0fc0b9c60bf49ea04a550a044/raw/REvoDesign_PyMOL.py
   

5. Click Fetch.

   

6. Confirm the installation when prompted.

   

7. Set the installation location (use the default if unsure) and click OK.

   

Once installed, the REvoDesign Package Manager will appear in the PyMOL menu.

---

Step 2: Install the Main Program

The REvoDesign Package Manager simplifies the installation of the core REvoDesign program. It supports various installation methods and configurations:

Features:

• Installation Sources:
  • Repository: Install directly from the remote repository.
  • Local clone/directory: Install from a local source code or cloned repository.
  • Local file: Install from a .zip or .tar.gz archive.
• Options:
  • Upgrade: Update to the latest release version.
  • Verbose: Show detailed installation logs.
  • Version/Commit: Install a specific version or commit from the repository.
• Network Control:
  • Proxy Support: Configure HTTP, HTTPS, SOCKS5, or SOCKS5h proxies.
  • Mirror: Use a PyPI mirror for installations.
• Extras:
  • Basic: Default installation.
  • Customized: Select additional features.
  • Everything: Install all extras (excluding test packages).
• Cache: Choose a custom cache directory or use the default.
• Self-Upgrades: Upgrade the package manager and UI directly.

---

Installation Methods

1. Remote Repository: Select Repository and click Install.

2. Local Clone: Use Local clone to install from a local repository or unzipped source code.

   

3. Local File: Select Local file to install from a .zip or .tar.gz file.

   

4. Specific Version/Commit: Check Version or Commit to install a specific release.

   

5. Customized/Extras: Use Customized to select specific features or Everything for a full installation.

   

---

Uninstallation

Use the Remove button in the manager to uninstall. You can also remove selected extras.

---

Network Settings

Set up proxies and mirrors to bypass network restrictions. For example, create a SOCKS5 proxy using SSH:

ssh -D 7899 -C root@<your.vps.ip> -p<ssh-port>

Configure the proxy in the manager:

---

Self-Upgrades

Right-click any non-editing area of the manager and select Upgrade this manager to fetch the latest version.

After confirming, the script will replace the existing manager with the updated version.

---

You are now ready to use REvoDesign for your enzyme redesign projects!

Extras table

extras tag and packages	references	explanations
ColabDesign	https://github.com/sokrypton/ColabDesign.git@v1.1.1	with JAX
DLPacker	https://github.com/YaoYinYing/DLPacker@pip-installable	with TensorFlow
PIPPack	https://github.com/YaoYinYing/PIPPack@pip-installable	with PyTorch

[!WARNING] ColabDesign uses Jax, which requires Python >= 3.9

[!IMPORTANT] Please make sure that modern PyMOL version is fetched from pymol-open-source channel, instead of obsolete PyMOL bundle (* < v2.5.7*, shipped with Python 3.7) from offical website or schrodinger's conda channel.

[!IMPORTANT] ALSO, for MacOS users work with Apple Silicon and PyMOL bundle >2.5.7, jaxlib builded with AVX will not work under Rosetta-2. Please consider using native build of pymol-open-source or building jaxlib from source.

Doc: Building jaxlib from source

Issue: CPU Support / Necessary AVX Instructions

1. Getting started:
   • In order to get started, you need to load/fetch a structure(fetch 1SUO, for example) into your PyMOL session.
   • Click Menu -> REvoDesign -> Import PyMOL Session to let REvoDesign find a designable molecule. Here is a keyboard shortcut: Ctrl+N.
   • Have fun!

Happy enzyme redesigning with REvoDesign! If you encounter any issues during installation or usage, please consult the documentation or seek assistance from REvoDesign toolkit's support resources.

---