Skip to content
Skills Library
Science & research · Building & coding

bindcraft

/bindcraft

End-to-end binder design using BindCraft hallucination. Use this skill when: (1) Designing protein binders with built-in AF2 validation, (2) Running production-quality binder campaigns, (3) Using different design protocols (fast, default, slow), (4) Need joint backbone and sequence optimization, (5) Want high experimental success rate. For backbone-only generation, use rfdiffusion. For QC thresholds, use protein-qc. For tool selection guidance, use binder-design.

Licence
MIT
Last repository change
11.06.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
3
Scripts
0
HTML comments
0
URLs in SKILL.md
2
Deprecation

No signals detected. Repository changed on 11.06.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What it does and when to use it

End-to-end binder design using BindCraft hallucination. Use this skill when: (1) Designing protein binders with built-in AF2 validation, (2) Running production-quality binder campaigns, (3) Using different design protocols (fast, default, slow), (4) Need joint backbone and sequence optimization, (5) Want high experimental success rate. For backbone-only generation, use rfdiffusion. For QC thresholds, use protein-qc. For tool selection guidance, use binder-design.

Original author description

End-to-end binder design using BindCraft hallucination. Use this skill when: (1) Designing protein binders with built-in AF2 validation, (2) Running production-quality binder campaigns, (3) Using different design protocols (fast, default, slow), (4) Need joint backbone and sequence optimization, (5) Want high experimental success rate. For backbone-only generation, use rfdiffusion. For QC thresholds, use protein-qc. For tool selection guidance, use binder-design.

How it works

  1. Prerequisites
  2. How to run
  3. Key parameters (Modal wrapper)
  4. Output format
  5. Sample output
  6. Decision tree
  7. Typical performance
  8. Verify
  9. Troubleshooting
Original SKILL.md headings · 175 lines, 662 words
SKILL.md preview
---
name: bindcraft
description: >
  End-to-end binder design using BindCraft hallucination. Use this skill when:
  (1) Designing protein binders with built-in AF2 validation,
  (2) Running production-quality binder campaigns,
  (3) Using different design protocols (fast, default, slow),
  (4) Need joint backbone and sequence optimization,
  (5) Want high experimental success rate.

  For backbone-only generation, use rfdiffusion.
  For QC thresholds, use protein-qc.
  For tool selection guidance, use binder-design.
license: MIT
category: design-tools
tags: [structure-design, sequence-design, binder, pipeline]
proteinbase_slug: bindcraft
proteinbase_url: https://proteinbase.com/design-methods/bindcraft
biomodals_script: modal_bindcraft.py
---

# BindCraft Binder Design

## Prerequisites

| Requirement | Minimum | Recommended |
|-------------|---------|-------------|
| Python | 3.9+ | 3.10 |
| CUDA | 11.7+ | 12.0+ |
| GPU VRAM | 32GB | 48GB (L40S) |
| RAM | 32GB | 64GB |

## How to run

> **First time?** See [Getting started](../../docs/getting-started.md) to set up Modal and biomodals.

### Option 1: Modal (recommended)
```bash
cd biomodals
modal run modal_bindcraft.py \
  --input-pdb target.pdb \
  --target-chains A \
  --target-hotspot-residues "45,67,89" \
  --lengths "70,100" \
  --number-of-final-designs 50
```

**GPU**: L40S (48GB) | **Timeout**: 300 min default

### Option 2: Local installation
```bash
git clone https://github.com/martinpacesa/BindCraft.git
cd BindCraft

# BindCraft is configured with JSON files, not flags
python -u ./bindcraft.py \
  --settings ./settings_target/mytarget.json \
  --filters ./settings_filters/default_filters.json \
  --advanced ./settings_advanced/default_4stage_multimer.json
```

The target PDB, chains, hotspots, and binder length range are set inside the
`--settings` JSON. See the BindCraft repo for the settings schema.

## Key parameters (Modal wrapper)

| Parameter | Default | Description |
|-----------|---------|-------------|
| `--input-pdb` | required | Target structure |
| `--target-chains` | `A` | Target chain(s) |
| `--target-hotspot-residues` | "" | Target hotspots (e.g. "45,67,89") |
| `--lengths` | `50,130` | Binder length range |
| `--number-of-final-designs` | 1 | Passing designs to return |
| `--max-trajectories` | none | Cap on trajectories |

## Output format

```
output/
├── design_0/
│   ├── binder.pdb         # Final design
│   ├── complex.pdb        # Binder + target
│   ├── metrics.json       # QC scores
│   └── trajectory/        # Optimization trajectory
├── design_1/
│   └── ...
└── summary.csv            # All metrics
```

### Metrics Output
```json
{
  "plddt": 0.89,
  "ptm": 0.78,
  "iptm": 0.62,
  "pae": 8.5,
  "rmsd": 1.2,
  "sequence": "MKTAYIAK..."
}
```

## Sample output

### Successful run
```
$ modal run modal_bindcraft.py --input-pdb target.pdb --target-chains A --target-hotspot-residues "45,67,89" --number-of-final-designs 50
[INFO] Loading BindCraft model...
[INFO] Target: target.pdb (chain A)
[INFO] Hotspots: 45, 67, 89
[INFO] Generating designs...

Design 1/50:
  Length: 78 AA
  pLDDT: 0.89, ipTM: 0.62
  Saved: output/design_0/

Design 50/50:
  Length: 85 AA
  pLDDT: 0.86, ipTM: 0.58
  Saved: output/design_49/

[INFO] Campaign complete. Summary: output/summary.csv
Pass rate: 32/50 (64%) with ipTM > 0.5
```

**What good output looks like:**
- pLDDT: > 0.85 for most designs
- ipTM: > 0.5 for passing designs
- Pass rate: 30-70% depending on target
- Diverse sequences across designs

## Decision tree

```
Should I use BindCraft?
│
├─ What type of design?
│  ├─ Production-quality binders → BindCraft ✓
│  ├─ High diversity exploration → RFdiffusion
│  └─ All-atom precision → BoltzGen
│
├─ What matters most?
│  ├─ Experimental success rate → BindCraft ✓
│  ├─ Speed / diversity → RFdiffusion + ProteinMPNN
│  ├─ AF2 gradient optimization → ColabDesign
│  └─ All-atom control → BoltzGen
│
└─ Compute resources?
   ├─ Have L40S/A100 → BindCraft ✓
   └─ Only A10G → RFdiffusion + ProteinMPNN
```

## Typical performance

| Campaign Size | Time (L40S) | Cost (Modal) | Notes |
|---------------|-------------|--------------|-------|
| 50 designs | 2-4h | ~$15 | Quick campaign |
| 100 designs | 4-8h | ~$30 | Standard |
| 200 designs | 8-16h | ~$60 | Large campaign |

Adaptyv's own tests of these models showed BindCraft costing about $2.90 per accepted
design, averaged across 7 targets.

**Experimental success rate** (BindCraft paper): 10 to 100%, averaging 46.3% across 12
targets; strongly target-dependent.

---

## Verify

```bash
find output -name "binder.pdb" | wc -l  # Should match num_designs
```

---

## Troubleshooting

**Low ipTM scores**: Check hotspot selection, increase designs
**Slow convergence**: Use fast protocol for screening
**OOM errors**: Reduce num_models, use L40S GPU
**Poor diversity**: Lower sampling_temp, run multiple seeds

### Error interpretation

| Error | Cause | Fix |
|-------|-------|-----|
| `RuntimeError: CUDA out of memory` | Large target or long binder | Use L40S/A100, reduce binder length |
| `ValueError: no hotspots` | Hotspots not found | Check residue numbering |
| `TimeoutError` | Design taking too long | Use fast protocol |

---

**Next**: Rank by `ipsae` → experimental validation.
Files in this package (3)
  • SKILL.md 5 KB
  • references/protocols.md 2 KB
  • references/troubleshooting.md 2 KB

Versions

RepositoryScoreLicence
This page · adaptyvbio/protein-design-skills100MIT
FreedomIntelligence/OpenClaw-Medical-Skills100MIT
liorz/protein-design-skills87MIT

Database snapshot: 13.11.2026 · package version b5fa5fb03671 (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 100binder-design
    Guidance for choosing the right protein binder design tool. Use this skill when: (1) Deciding between BoltzGen, BindCraft, or RFdiffusion, (2) Planning a binder design campaign, (3) Understanding trade-offs between different approaches, (4) Selecting tools for specific target…
  • 100binder-design
    Guidance for choosing the right protein binder design tool. Use this skill when: (1) Deciding between BoltzGen, BindCraft, or RFdiffusion, (2) Planning a binder design campaign, (3) Understanding trade-offs between different approaches, (4) Selecting tools for specific target…
  • 100protein-binder-design
    Design new proteins that bind a chosen surface, using BindCraft's AlphaFold2-guided hallucination or the RFdiffusion backbone plus ProteinMPNN sequence pipeline. Use this skill to specify a target epitope by hotspot residue, trim a receptor to the region worth designing against,…
  • 100mosaic
    Multi-objective, gradient-based protein binder design with Mosaic. Use this skill when: (1) Composing several structure or sequence models into one design objective, (2) Optimizing binders against a custom loss rather than a fixed pipeline, (3) Wanting gradient descent over…
  • 100ipsae
    Binder design ranking using ipSAE (interprotein Score from Aligned Errors). Use this skill when: (1) Ranking binder designs for experimental testing, (2) Filtering BindCraft or RFdiffusion outputs, (3) Comparing AF2/AF3/Boltz predictions, (4) Predicting binding success rates,…
  • 100protein-binder-design
    Orchestrate an end-to-end de novo protein binder design campaign against a protein target by composing BioNeMo NIM skills. Use for binder design, minibinder design, de novo binders, RFdiffusion + ProteinMPNN + Boltz2/OpenFold3 pipelines, epitope/hotspot-targeted design,…

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.