DiffAb

Design new antibody CDRs based on an antigen structure. CDRs are antibody regions involved in target recognition.

API/CLI tool ID: diffab

Understanding inputs and outputs

An antigen is the target recognized by an antibody. Supply a structure containing the antibody heavy chain, light chain and antigen, and specify their chain IDs. H and L describe heavy- and light-chain roles; the actual chain IDs in the file need not be H and L.

Select one region in cdr for redesign. H_CDR3 is the third CDR of the heavy chain; 3 does not mean the third amino acid in its sequence. Regions follow the Chothia antibody numbering scheme. numDesigns is the number of candidates for the selected region, and the representative file is the first candidate. Generation order is not a ranking of binding strength, and changing a CDR does not establish improved binding to the target.

Input settings

SettingFormatRequiredDefaultDescription and constraints
pdbFilepdbRequired—A single PDB containing the heavy and light chains. All other chains are treated as antigen. — Extensions pdb · cif
antigenChainschainsRequired—Chain IDs to treat as the antigen — Example ["C"]
heavyChainchainRequired—Antibody heavy-chain ID — Example "H"
lightChainchainRequired—Antibody light-chain ID — Example "L"
cdrdropdownOptional"H_CDR3"One CDR region to redesign (Chothia numbering) — Allowed values H_CDR1 · H_CDR2 · H_CDR3 · L_CDR1 · L_CDR2 · L_CDR3
numDesignsnumberOptional8Number of candidates for the selected CDR. The representative file is the first candidate, not the best-ranked one. — Minimum 1, Maximum 500

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
CodeApache-2.0Allowed, subject to notice requirementsLicense text—
Model weightsApache-2.0Allowed, subject to notice requirementsWeight distribution metadataModel-card license of the Hugging Face weights repository linked in the README
CodeLicenseRef-PyRosetta-NonCommercialSeparate commercial agreement requiredOfficial terms and distribution informationPyRosetta terms for optional post-processing and energy evaluation. Commercial use requires a separate agreement, including paid services for academic users. This differs from using main-model inference alone
  • Post-processing and energy evaluation that include PyRosetta require a separate commercial agreement. Check the execution plan for the configuration and terms that apply. Official guidance

The repository is archived. Apache-2.0 for the main code and weights does not replace PyRosetta's separate terms

Checked on 2026-10-06.

References

On this page