Turn any AI agent into an AI Scientist. The #1 Agent Skills library for science, used by 250,000+ scientists worldwide. 177 ready-to-use validated skills plus 100+ scientific databases covering biology, chemistry, medicine, and drug discovery. Compatible with Cursor, Claude Code, Codex, Pi, Antigravity, and the open Agent Skills standard.
DiffDock v1.1.3 inference contract
Reviewed 2026-09-30 against released inference.py, its YAML, and current main
(commit 85c49b60d3e0b0182a59ee43a34a6d7036981284, same inference file).
This covers user-complex inference, not evaluate or training.
Configuration wins over command line
main() loads YAML after argparse and overwrites matching argument values.
Therefore --config default_inference_args.yaml --samples_per_complex 20 still
uses the YAML value 10. Edit a copied YAML for any key present there. YAML accepts
unknown keys without validating that inference uses them; acceptance is not support.
The bundled assets/custom_inference_config.yaml retains the released numerical
sampling defaults, contains only consumed inference settings, and explicitly uses
old_confidence_model, the actual parser/model-construction name.
| Option | Released effective default with default YAML | Meaning |
|---|---|---|
model_dir |
./workdir/v1.1/score_model |
Score model parameters/checkpoint |
confidence_model_dir |
./workdir/v1.1/confidence_model |
Confidence model parameters/checkpoint |
ckpt |
best_ema_inference_epoch_model.pt |
Score weights |
confidence_ckpt |
best_model_epoch75.pt |
Confidence weights; parser alone instead defaults to best_model.pt |
old_score_model |
false | Architecture switch, requiring compatible weights; not a model downloader |
old_confidence_model |
true | Confidence architecture switch |
samples_per_complex |
10 | Pose candidates per pair |
batch_size |
10 | Samples processed together within a complex; complexes iterate one at a time |
inference_steps |
20 | Construct the diffusion time schedule |
actual_steps |
19 | Number of sampling steps executed; keep consistent with schedule |
no_final_step_noise |
true | Omit last-step stochastic noise |
initial_noise_std_proportion |
1.4601642460337794 | Initial translation noise setting |
choose_residue |
false | Alternative initial positioning near sampled residue |
save_visualisation |
false | Additional reverse-process PDB trajectory; pose SDFs always written |
out_dir |
results/user_inference |
Run-specific output directory |
loglevel |
WARNING | -l, --log, or --loglevel; INFO includes successful-run summary |
Temperature defaults (copy full precision from the asset): translation/rotation/
torsion temp_sampling approximately 1.170/2.064/7.044, temp_psi 0.727/0.902/0.595,
temp_sigma_data 0.930/0.746/0.694. Psi is a sampler weighting parameter, not a
protein psi dihedral. These coupled settings are empirically tuned. Increasing one
does not establish monotonic diversity or accuracy; no validated flexible/rigid presets
are supplied. More candidates can improve search coverage, without guaranteeing success.
Input options
protein_ligand_csv: columnscomplex_name,protein_path,ligand_description,protein_sequence. Overrides single-complex inputs. Upstream fills blank names withcomplex_<index>; the helper intentionally requires explicit safe unique names to avoid collisions.- Single pair:
complex_name,protein_pathorprotein_sequence, andligand_description. Always use the full latter name; README's--ligandworks only as argparse's currently unambiguous abbreviation, not a registered alias. - Protein paths and ligand file paths resolve relative to process CWD, not CSV location.
- Ligands: SMILES attempted first, then
.sdf,.mol2,.pdb,.pdbqtreaders. Only the first SDF record is used. Input file conformers are removed and regenerated; a supplied pose is not a starting-pose restraint. Preserve stereochemistry and IDs.
Options that do not work as formerly documented
--esm_embeddings_path, --chain_cutoff, --split, --tqdm, --ode, --no_random,
--no_model, --resample_rdkit, and --limit_failures are not inference parser options.
Some belong to evaluation/training. The released default YAML contains historical
keys (old_filtering_model, sigma_schedule, inf_sched_alpha/beta, no_random,
no_random_pocket, resample_rdkit, ode, different_schedules, limit_failures,
no_model) which this inference path does not consume. Inference hard-codes the
expbeta schedule. Do not present unused YAML values as operational controls.
The parser also exposes gnina_* fields, but main() never passes them into the
sampler's GNINA branch; use a separate verified GNINA invocation for refinement.
Do not disable the confidence model: output writing indexes its scores.
datasets/esm_embedding_preparation.py has --dataset, --data_dir, --out_file,
not --protein_ligand_csv; it prepares FASTA (PDBBind) or sequence dictionaries
(MOAD), not a .pt embedding tensor. Arbitrary user-complex inference generates
ESM2 embeddings internally and has no public CLI embedding-cache flag.