Skip to content

lamm-mit/ModeShapeDiffusionDesign

Repository files navigation

VibeGen: Agentic End-to-End De Novo Protein Design for Tailored Dynamics Using a Language Diffusion Model

Bo Ni1,2, Markus J. Buehler1,3,4*

1 Laboratory for Atomistic and Molecular Mechanics (LAMM), Massachusetts Institute of Technology

2 Department of Materials Science and Engineering, Carnegie Mellon University

3 Center for Computational Science and Engineering, Schwarzman College of Computing, Massachusetts Institute of Technology

4 Lead contact

* Correspondence: mbuehler@MIT.EDU

Proteins are dynamic molecular machines whose biological functions, spanning enzymatic catalysis, signal transduction, and structural adaptation, are intrinsically linked to their motions. We introduce VibeGen, a generative AI model based on an agentic dual-model architecture, comprising a protein designer that generates sequence candidates based on specified vibrational modes and a protein predictor that evaluates their dynamic accuracy. Via direct validation using full-atom molecular simulations, we demonstrate that the designed proteins accurately reproduce the prescribed normal mode amplitudes across the backbone while adopting various stable, functionally relevant structures. Generated sequences are de novo, exhibiting no significant similarity to natural proteins, thereby expanding the accessible protein space beyond evolutionary constraints. Our model establishes a direct, bidirectional link between sequence and vibrational behavior, unlocking new pathways for engineering biomolecules with tailored dynamical and functional properties. Our model holds broad implications for the rational design of enzymes, dynamic scaffolds, and biomaterials via dynamics-informed protein engineering.

plot

Installation

Create a virtual environment

conda create --prefix=./VibeGen_env 
conda activate ./VibeGen_env

Install:

pip install git+https://github.com/lamm-mit/ModeShapeDiffusionDesign.git

If you want to create an editable installation, clone the repository using git:

git clone https://github.com/lamm-mit/ModeShapeDiffusionDesign.git
cd ModeShapeDiffusionDesign

Then, install:

pip install -r requirements.txt
pip install -e .

Directory structure

ModeShapeDiffusionDesign/
│
├── VibeGen/                                    # Source code directory
│   ├── DataSetPack.py
│   ├── ModelPack.py
│   ├── TrainerPack.py
│   ├── UtilityPack.py
│   ├── JointSamplingPack.py
│   └── ...
│
├── demo_1_Inferrence_with_trained_duo.ipynb    # demo 1: make an inference
│
├── colab_demo/                                 # demos for colab
│   ├── Inference_demo.ipynb                    # demo 1: make an inference
│   └── ...
│
├── setup.py                                    # The setup file for packaging
├── requirements.txt                            # List of dependencies
├── README.md                                   # Documentation
├── assets/                                     # Support materials
└── ...

Usage

Inference notebooks

In the following example, for each input normal mode shape condition, we use the trained ProteinDesigner to propose 20 candidates. Then the trained ProteinPredictor will pick the best and worst two from them based on its predition. The chosen seqeucnes then will be folded using OmegaFold and the seondary strucutre of them will be analyzed.

demo_1_inference_with_trained_duo.ipynb

Alternatively, similar demo can run using Colab.

Open in Colab

Pretrained models

The checkpoints of the pretrained models that make up the agentic system is hosted at the repository on Huggingface.

Reference

@paper{BoBuehler2025VibeGen,
      title={VibeGen: Agentic End-to-End De Novo Protein Design for Tailored Dynamics Using a Language Diffusion Model}, 
      author={Bo Ni and Markus J. Buehler},
      year={2025},
      eprint={2502.10173},
      archivePrefix={arXiv},
      primaryClass={q-bio.BM},
      url={https://arxiv.org/abs/2502.10173}, 
}

Our implementation is inspired by the imagen-pytorch repository by Phil Wang.

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 2

  •  
  •