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
| Setting | Format | Required | Default | Description and constraints |
|---|---|---|---|---|
pdbFile | pdb | Required | — | A single PDB containing the heavy and light chains. All other chains are treated as antigen. — Extensions pdb · cif |
antigenChains | chains | Required | — | Chain IDs to treat as the antigen — Example ["C"] |
heavyChain | chain | Required | — | Antibody heavy-chain ID — Example "H" |
lightChain | chain | Required | — | Antibody light-chain ID — Example "L" |
cdr | dropdown | Optional | "H_CDR3" | One CDR region to redesign (Chothia numbering) — Allowed values H_CDR1 · H_CDR2 · H_CDR3 · L_CDR1 · L_CDR2 · L_CDR3 |
numDesigns | number | Optional | 8 | Number 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.
| Component | License | Commercial use | Source | Notes |
|---|---|---|---|---|
| Code | Apache-2.0 | Allowed, subject to notice requirements | License text | — |
| Model weights | Apache-2.0 | Allowed, subject to notice requirements | Weight distribution metadata | Model-card license of the Hugging Face weights repository linked in the README |
| Code | LicenseRef-PyRosetta-NonCommercial | Separate commercial agreement required | Official terms and distribution information | PyRosetta 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.