ImmuneBuilder

Predict variable-domain structures in antibodies, nanobodies, and TCRs. These domains are involved in target recognition.

API/CLI tool ID: immunebuilder

The input fields depend on the value of modelType.

Understanding inputs and outputs

The variable region is the part of an antibody or T-cell receptor involved in target recognition. Supply amino acid sequences for this region, rather than the entire protein. TCR stands for T-cell receptor.

For Antibody, put the heavy chain (H) in sequence1 and the light chain (L) in sequence2. Nanobody handles a small single-domain antibody and uses only sequence1. For TCR, sequence1 is the alpha chain (A) and sequence2 is the beta chain (B). Do not concatenate different chains into one input.

The result is a predicted structure of the supplied variable region. It is not a binding prediction calculated together with a target molecule, so obtaining a structure does not establish which target it binds or how strongly.

The B-factor column of the final structure file is not pLDDT. ImmuneBuilder predicts several models together, converts how widely their coordinates spread into a per-residue predicted error, and writes that value in ångström (Å) in this column. A larger value means the position of that residue is less certain, so the good direction is the opposite of pLDDT. Do not pass this file to a tool that reads B-factor as pLDDT.

Input settings

SettingFormatRequiredDefaultDescription and constraints
modelTypetaskOptional"Antibody"Antibody = H+L, nanobody = H, TCR = A (alpha) + B (beta) — Allowed values Antibody · Nanobody · TCR
sequence1sequenceRequired—Characters ACDEFGHIKLMNPQRSTVWY , Single chain only, Maximum length 150, Example "EVQLVQSGPEVKKPGTSVKVSCKASGFTFMSSAVQWVRQARGQRLEWIGWIVIGSGNTNYAQKFQERVTITRDMSTSTAYMELSSLRSEDTAVYYCAAPYCSSISCNDGFDIWGQGTMVTVS"
sequence2sequenceConditionally required—Characters ACDEFGHIKLMNPQRSTVWY , Single chain only, Maximum length 130, Applies to Antibody · TCR, Example "DIQMTQSPSSLSASVGDRVTITCRASQDVNTAVAWYQQKPGKAPKLLIYSASFLYSGVPSRFSGSRSGTDFTLTISSLQPEDFATYYCQQHYTTPPTFGQGTKVEIK"

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
CodeBSD-3-ClauseAllowed, subject to notice requirementsLicense text—
Model weightsCC-BY-4.0Conditional; see notesWeight distribution metadataLicense of the Zenodo record (7258553) downloaded by the package. Attribution is required
Model weightsCC-BY-4.0Conditional; see notesWeight distribution metadataDistribution record for TCRBuilder2's additional tcr2_plus weights. This is separate from the existing weights and requires source, license and modification notices

Checked on 2026-10-06.

References

On this page