RFantibody

Design new antibody and nanobody CDRs from an antigen structure and an antibody framework, proceeding through backbone design, sequence design, and structure filtering.

API/CLI tool ID: rfantibody

Understanding inputs and outputs

The antigen is the target recognized by the antibody; its structure goes in targetPdb. frameworkPdb contains the antibody framework that supports the regions around the CDRs. The backbone is the protein’s common structural scaffold, while the sequence is the order of its amino acids. numDesigns sets the number of backbone candidates, and seqsPerStruct sets sequences per backbone; they count different things.

temperature controls diversity during sequence sampling; it is not an experimental temperature. pred_lddt is structural confidence on a 0–1 scale. interaction_pae is the predicted error in the relative placement of antibody and antigen, while framework_aligned_cdr_rmsd measures CDR displacement after aligning the frameworks. Small errors or displacements do not establish actual binding or antibody function.

Input settings

SettingFormatRequiredDefaultDescription and constraints
targetPdbpdbRequired—Experimental antigen (target) structure — Extensions pdb · cif
frameworkPdbpdbRequired—Antibody framework structure (the official framework from the repository's design campaign is provided) — Extensions pdb · cif
numDesignsnumberOptional10Number of backbone designs to generate (rfdiffusion -n, 1–100). For more than 100, contact us at /contact?topic=pricing with the number you need and your input size. — Minimum 1, Maximum 100
temperaturenumberOptional0.1ProteinMPNN sampling temperature (documented default: 0.1) — Minimum 0, Maximum 1
seqsPerStructnumberOptional4Sequences to design per structure (proteinmpnn -n) — Minimum 1, Maximum 64
numRecyclesnumberOptional10RF2 recycling steps (documented default: 10) — Minimum 1, Maximum 30
deterministicbooleanOptionalfalseReproducible run (--deterministic)
seednumberOptional—Random seed for reproducibility (rf2 -s)

Output metrics

ColumnDisplay nameRangeUnitDescription
pred_lddtRF2 pLDDT (0–1)0~1—Structure confidence from the RF2 filter. Not affinity or the probability of experimental success.
interaction_paeInterface PAE—ÅPredicted aligned error at the antibody–antigen interface
paePAE—ÅPredicted aligned error of the whole complex
framework_aligned_cdr_rmsdCDR RMSD—ÅCDR displacement after aligning on the framework

See Reading results for metric definitions and interpretation. A range shows possible values; whether higher or lower is better depends on the metric.

Execution availability

Open an execution plan in your project to see available tool versions and costs. Review and approve the inputs, settings, and terms before running.

License

Code, model weights, and accompanying data have their own terms. The table summarizes terms from official sources; check your execution plan for the configuration you will use. License texts are available in Third-party notices.

ComponentLicenseCommercial useSourceNotes
CodeMITAllowed, subject to notice requirementsLicense text—
Model weightsMITAllowed, subject to notice requirementsOfficial terms and distribution informationThe RFdiffusion_Ab, ProteinMPNN_v48_noise_0.2, and RF2_ab weights may be used under the MIT license, as confirmed in the official repository. Copyright and permission notices must be retained.
Model weightsCC-BY-4.0Conditional; see notesWeight distribution metadataADAPT immune-receptor design parameters (RFab_noframework-nosidechains-5-10-23_trainingparamsadded.pt) use CC BY 4.0 and require attribution.

The pipeline includes RFdiffusion, ProteinMPNN, and an antibody-tuned RoseTTAFold2 filter; PyRosetta is not required. RF2 code is bundled in the repository. The NVIDIA base container permits hosted services, but its distribution conditions also apply to internet services. Do not expose NVIDIA APIs directly; provide substantial additional functionality and comply with protective terms, notices, and separate component licenses.

Checked on 2026-11-09.

References

On this page