Who it is forA drug discovery scientist triaging a list of candidate ligands against one target.
The problemPhysics-based free-energy methods are accurate but far too slow to run on every candidate in a screen.
The outcomeA per-ligand affinity_probability_binary score from 0 to 1 that ranks which molecules look like binders.
What you need first
- Python in a fresh environment and pip
- An NVIDIA GPU for the [cuda] install; CPU-only works but is significantly slower
- Input YAML files describing the biomolecules (format in docs/prediction.md)
- Network access for the optional MSA server (--use_msa_server)
Steps
- Install with
pip install boltz[cuda] -U - Write one YAML per protein and ligand pair that asks for the affinity property, as described in docs/prediction.md
- Put the YAML files in one directory and run
boltz predict input_path --use_msa_serveron that directory for batched processing - Read affinity_probability_binary for each ligand to detect binders from decoys
- Send only the top candidates on to slower methods or the lab
Prompt for your agent
With jwohlwend/boltz, build a directory of YAML inputs pairing <target protein> with each ligand in <list>, requesting affinity, and run `boltz predict input_path --use_msa_server` on it. Rank the ligands by affinity_probability_binary.
Caveat. The README says affinity_probability_binary is for hit discovery and affinity_pred_value for lead optimization; do not mix them up.
Use this in your AI agent
Ask your agent
Using the Deduped MCP, get the setup steps for jwohlwend/boltz and "Screen small molecules for likely binders"
Add Deduped to Claude Code once
claude mcp add --transport http deduped https://dedupedai.com/mcp
Every Monday: the 5 hottest repos and exactly how to use them. Free, one email a week, unsubscribe anytime.
Get them freeShare: X LinkedIn Hacker News Email Copy link
Third-party repos we don't own. AI-written use cases can be wrong. Disclaimer