How to Run Boltz-2

by Corin Wagen · Jun 6, 2025

Today, a team of researchers from MIT and Recursion released Boltz-2, an open-source protein–ligand co-folding model. Boltz-2 can not only predict the structure of biomolecular complexes from sequences, it also "approaches the accuracy of FEP-based methods" at protein–ligand binding-affinity prediction (source).

In a set of binding-affinity benchmarks, the authors show that Boltz-2 performs almost as well as the industry-standard FEP+ workflow and handily outperforms cheaper physics-based methods like MM/PBSA, although performance is considerably worse on internal targets from Recursion:

Comparison of Boltz-2 to other methods.

Figure 6 from the Boltz-2 paper.

While full assessment of Boltz-2's capabilities will require extensive benchmarking and external verification, it's already possible for scientists to start using Boltz-2 for their own projects. In this post, we provide step-by-step guides on how to run Boltz-2 locally and through Rowan's computational-chemistry platform.

(Curious about how Boltz-2 works? Check out this FAQ to learn more about what the model's trained on, where it can be useful, and where it still has limitations.)

Running Locally

1. Install Boltz-2

Boltz-2 is an open-source model and can be installed from the Python Package Index. You can install this any number of ways; we like using pixi for dependency management.

pixi init
pixi add python=3.12
pixi add --pypi boltz

2. Create a Template .yaml File

Boltz-2 requires a specific input-file syntax. The authors provide several examples in their GitHub repository; here's the example .yaml file for predicting protein–ligand binding affinity.

version: 1  # Optional, defaults to 1
sequences:
  - protein:
      id: A
      sequence: MVTPEGNVSLVDESLLVGVTDEDRAVRSAHQFYERLIGLWAPAVMEAAHELGVFAALAEAPADSGELARRLDCDARAMRVLLDALYAYDVIDRIHDTNGFRYLLSAEARECLLPGTLFSLVGKFMHDINVAWPAWRNLAEVVRHGARDTSGAESPNGIAQEDYESLVGGINFWAPPIVTTLSRKLRASGRSGDATASVLDVGCGTGLYSQLLLREFPRWTATGLDVERIATLANAQALRLGVEERFATRAGDFWRGGWGTGYDLVLFANIFHLQTPASAVRLMRHAAACLAPDGLVAVVDQIVDADREPKTPQDRFALLFAASMTNTGGGDAYTFQEYEEWFTAAGLQRIETLDTPMHRILLARRATEPSAVPEGQASENLYFQ
  - ligand:
      id: B
      smiles: 'N[C@@H](Cc1ccc(O)cc1)C(=O)O'
properties:
  - affinity:
      binder: B

Boltz-2 does not yet support protein–protein binding affinity or predicting binding affinity for multiple ligands.

3. Run Boltz-2 Locally

To run Boltz-2, initialize the environment shell and then use boltz predict to run the model.

pixi shell
boltz predict affinity.yaml --use_msa_server

This call will take a little while to run; make sure your computer has enough disk space to download the model weights! When finished, Boltz-2 will write a bunch of directories and .json files containing predictions. The predictions will be located in output/predictions/[input-file]/affinity-[input-file].json, and will contain predicted IC50 values (in micromolar) and binary probability that the compound is a binder.

Boltz-2 is a complex package and this guide barely scratches the surface. For a full guide to running prediction with Boltz-2, see the authors' documentation.

Running Through Rowan

To quickly use Boltz-2 for binding-affinity prediction, calculations can also be run through Rowan. Creating an account on Rowan is completely free and can be done using any Google-managed email account; create an account here.

1. Choose Workflow

Selecting the protein-ligand co-Folding workflow.

Once you sign in to Rowan, you can select which workflow you want to run. Here, we'll select the "Protein–Ligand Co-Folding" workflow (towards the bottom of the screen).

2. Enter Protein and Ligand

Inputting a sucrose molecule.

Proteins can be specified by sequence; existing protein structures in Rowan won't work, because this is co-folding—we don't want to start with a 3D structure.

Molecules can be loaded into Rowan by name, by SMILES, by input file, or through our provided 2D and 3D editors. Here, we'll input the molecule from the above demo by SMILES.

3. Run Calculation

The finished calculation results.

Once you click “Submit Calculation,” we'll allocate a cloud GPU and start running Boltz-2 on your system. The calculations should be done in a few minutes and can be viewed through the browser.

Rowan displays the predicted protein–ligand complex through our 3D viewer, with predicted binding affinity and confidence metrics on the side. The complex can be downloaded as a PDB file for further analysis.

Banner background image

What to Read Next

ExpBDE54: A Slim Experimental Benchmark for Exploring the Pareto Frontier of Bond-Dissociation-Enthalpy-Prediction Methods

ExpBDE54: A Slim Experimental Benchmark for Exploring the Pareto Frontier of Bond-Dissociation-Enthalpy-Prediction Methods

ExpBDE54 is a benchmark dataset of experimental homolytic bond-dissociation enthalpies (BDEs) for 54 small molecules, used for benchmarking DFT, semiempirical methods, and NNPs.
Jul 17, 2025 · Jonathon E. Vandezande, Corin C. Wagen
Benchmarking Protein–Ligand Interaction Energy

Benchmarking Protein–Ligand Interaction Energy

How new low-cost computational methods perform on the PLA15 benchmark.
Jul 11, 2025 · Ishaan Ganti
Efficient Black-Box Prediction of Hydrogen-Bond-Donor and Acceptor Strength

Efficient Black-Box Prediction of Hydrogen-Bond-Donor and Acceptor Strength

Here, we report a robust black-box workflow for predicting site-specific hydrogen-bond basicity and acidity in organic molecules with minimal computational cost.
Jul 1, 2025 · Corin C. Wagen
Tracking Boltz-2 Benchmarks

Tracking Boltz-2 Benchmarks

Tracking the community's response to the new Boltz-2 model, plus some notes about Chai-2.
Jul 1, 2025 · Corin Wagen
g-xTB, Credit Usage, & More

g-xTB, Credit Usage, & More

the new g-xTB model from Grimme and co-workers; an easy visual overview of credit usage; better credit handling for organizations; bulk PDB download; a new collapsible JSON viewer
Jun 27, 2025 · Jonathon Vandezande, Ari Wagen, Spencer Schneider, and Corin Wagen
Representing Local Protein Environments With Atomistic Foundation Models

Representing Local Protein Environments With Atomistic Foundation Models

A guest post about how to use NNP embeddings for other prediction tasks.
Jun 20, 2025 · Meital Bojan and Sanketh Vedula
Co-Folding Updates

Co-Folding Updates

Boltz-2 FAQ and launch event recap; new visuals for co-folding workflows; new submission options; PDB bugfixes; new credit-management tools
Jun 12, 2025 · Ari Wagen, Spencer Schneider, and Corin Wagen
The Boltz-2 FAQ

The Boltz-2 FAQ

Questions and answers about the Boltz-2 biomolecular foundation model.
Jun 9, 2025 · Corin Wagen and Ari Wagen
Cleaning the Tap Room

Cleaning the Tap Room

beer and bezos; terms-of-service and privacy-policy updates; more deployment options; compliance requirements and country restrictions; a blog post about transition states
Jun 6, 2025 · Ari Wagen and Corin Wagen
BREAKING: Boltz-2 Now Live On Rowan

BREAKING: Boltz-2 Now Live On Rowan

This morning, a team of researchers from MIT and Recursion released Boltz-2, an open-source protein–ligand co-folding model.
Jun 6, 2025 · Corin Wagen, Spencer Schneider, and Ari Wagen