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

The Invisible Work of Computer-Assisted Drug Design

The Invisible Work of Computer-Assisted Drug Design

Everything that happens before the actual designing of drugs, and how Rowan tries to help.
Aug 28, 2025 · Corin Wagen
MSA, Protein–Ligand Binding Affinity Exploration, and Stereochemistry

MSA, Protein–Ligand Binding Affinity Exploration, and Stereochemistry

MSA-related occurrences and our incident postmortem; MSA server coming soon; exploring new approaches to binding-affinity prediction; a farewell to interns; a new stereochemistry lab
Aug 22, 2025 · Ari Wagen, Corin Wagen, and Spencer Schneider
Co-Folding Failures, Our Response, and Rowan-Hosted MSA

Co-Folding Failures, Our Response, and Rowan-Hosted MSA

A narrative account of our response to a sudden rise in protein–ligand co-folding failures.
Aug 22, 2025 · Ari Wagen
Exploring Protein–Ligand Binding-Affinity Prediction

Exploring Protein–Ligand Binding-Affinity Prediction

Trying a few modern ML-based approaches for predicting protein–ligand binding affinity.
Aug 20, 2025 · Ishaan Ganti
What Ishaan and Vedant Learned This Summer

What Ishaan and Vedant Learned This Summer

Reflections from two of our interns on their time at Rowan and a few things they learned.
Aug 15, 2025 · Ishaan Ganti and Vedant Nilabh
Projects: Organization, Sharing, and Saving Structures

Projects: Organization, Sharing, and Saving Structures

better organization through projects; saving structures; usage tracking; new conf. search features; second-order SCF; ex. API repo; SMILES imports; a guide to the pKa-perplexed; our inaugural demo day
Aug 14, 2025 · Ari Wagen, Spencer Schneider, Corin Wagen, and Jonathon Vandezande
Macroscopic and Microscopic pKa

Macroscopic and Microscopic pKa

Two different ways to calculate acidity, what they mean, and when to use them.
Aug 11, 2025 · Corin Wagen
Computational Chemistry in the Classroom

Computational Chemistry in the Classroom

chemical modeling; Diels–Alder; call for more labs
Jul 31, 2025 · Jonathon Vandezande and Isaiah Sippel
Modeling Thia-Michael Reactions

Modeling Thia-Michael Reactions

In which the addition of a thiolate to an enone proves to be unexpectedly difficult to model.
Jul 25, 2025 · Corin Wagen
API v2, New BDE Methods, MCP, And More

API v2, New BDE Methods, MCP, And More

new API philosophy; streamlined interfaces for workflows; using NNPs and g-xTB to predict bond strength; an MCP server; .sdf files; benchmarking protein–ligand interactions; Diels–Alder visualizations
Jul 21, 2025 · Spencer Schneider, Corin Wagen, Ari Wagen, Jonathon Vandezande, Ishaan Ganti, and Isaiah Sippel