NVIDIA/skills / skills/bionemo-diffdock-nim
diffdock-nim
UnverifiedRun DiffDock molecular docking via NVIDIA NIM to predict small-molecule binding poses against protein targets. Use for DiffDock, molecular docking, ligand docking, blind docking, SMILES or SDF ligands, ranked poses, confidence scores, hosted NVIDIA API, or local Docker deployment.
DiffDock NIM
Predict protein-ligand binding poses with blind docking. Use this guide for first-pass hosted/local usage; load supplemental files only when needed:
references/api.md: exact hosted/local endpoints, schemas, Docker flags.references/science.md: docking use cases, limits, and handoffs.references/parameters.md: ligand formats, pose counts, diffusion controls.references/validation.md: receptor, ligand, pose, and confidence checks.references/examples.md: compact hosted/local and pose-saving patterns.
Choose Mode
Ask only when context is unclear:
Hosted NVIDIA API or local Docker NIM?
- Hosted:
https://health.api.nvidia.com/v1/biology/mit/diffdock - Local:
http://localhost:8000/molecular-docking/diffdock/generate
The hosted and local paths differ. Local has no /v1/ prefix and uses the
/molecular-docking/ route. Hosted requests use Authorization: Bearer $NGC_API_KEY. Supported local Docker
startup uses NGC_API_KEY (or NVIDIA_API_KEY via the preflight) for
registry login, entitlement checks, and first-run model downloads; pass it
into the container with -e NGC_API_KEY. Local inference requests use no
auth header after readiness. Warm-cache key-free startup varies by
image/version and should not be assumed.
Local Docker
For the exact local preflight (.env load, NVIDIA_API_KEY fallback,
LOCAL_NIM_CACHE, NVIDIA_VISIBLE_DEVICES=0, --shm-size=2G, both --ulimit
flags, docker login, and the docker run for nvcr.io/nim/mit/diffdock:2.2.0),
copy the command block in references/api.md under
Docker Reference verbatim.
Readiness:
until curl -sf http://localhost:8000/v1/health/ready; do sleep 5; done
Prepare Inputs
Protein receptor must be ATOM records only. Strip headers, water, and HETATM.
from pathlib import Path
raw_pdb = Path("protein.pdb").read_text()
protein = "\n".join(line for line in raw_pdb.splitlines() if line.startswith("ATOM"))
if not protein:
raise ValueError("protein.pdb has no ATOM records")
Ligand options:
- SMILES:
ligand = "CC(=O)OC1=CC=CC=C1C(=O)O";ligand_file_type = "txt". - SDF:
ligand = Path("ligand.sdf").read_text();ligand_file_type = "sdf". - MOL2:
ligand_file_type = "mol2".
Do not use "smiles" as ligand_file_type; SMILES is "txt".
Request Pattern
import os
import requests
HOSTED = True
url = (
"https://health.api.nvidia.com/v1/biology/mit/diffdock"
if HOSTED else "http://localhost:8000/molecular-docking/diffdock/generate"
)
headers = {"Content-Type": "application/json"}
if HOSTED:
headers["Authorization"] = f"Bearer {os.getenv('NGC_API_KEY')}"
payload = {
"protein": protein,
"ligand": ligand,
"ligand_file_type": ligand_file_type,
"num_poses": 10,
"time_divisions": 20,
"steps": 18,
"save_trajectory": False,
}
response = requests.post(url, headers=headers, json=payload, timeout=300)
response.raise_for_status()
result = response.json()
Save And Report Output
ligand_positions and position_confidence are parallel ranked lists.
position_confidence[0] is the rank-1 pose confidence.
Save the ranked pose SDFs using the snippet in
references/examples.md under Save Ranked Poses.
View pose SDF files with the receptor in PyMOL, ChimeraX, or UCSF Chimera. For
pose sanity checks and confidence caveats, read references/validation.md.
Limits And Troubleshooting
- Max
num_poses: 100. Maxtime_divisions: 20. Maxsteps: 18. - Single GPU; local minimum is about 24 GB VRAM.
422: invalidligand_file_type, invalid SMILES/SDF, or no ATOM records.- Empty poses: validate receptor ATOM records and ligand parseability.
- Local URL 404 usually means the wrong hosted path or an accidental
/v1/.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| writing-skillsobra/superpowersUse when creating new skills, editing existing skills, or verifying skills work before deployment | Stars: 318k | Updated | Claude CodeCodex | Unverified | Install |
| xlsxanthropics/skillsUse this skill any time a spreadsheet file is the primary input or output. This means any task where the user wants to: open, read, edit, or fix an existing .xlsx, .xlsm, .xltx, .csv, or .tsv file (e.g., adding columns, computing formulas, formatting, charting, cleaning messy data); create a new spreadsheet from scratch or from other data sources; or convert between tabular file formats. Trigger especially when the user references a spreadsheet file by name or path — even casually (like "the xlsx in my downloads") — and wants something done to it or produced from it. Also trigger for cleaning or restructuring messy tabular data files (malformed rows, misplaced headers, junk data) into proper spreadsheets. The deliverable must be a spreadsheet file. Do NOT trigger when the primary deliverable is a Word document, HTML report, standalone Python script, database pipeline, or Google Sheets API integration, even if tabular data is involved. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| shipping-and-launchaddyosmani/agent-skillsPrepares production launches. Use when preparing to deploy to production, or when asking what needs to be in place before shipping. Use when you need a pre-launch checklist, when setting up monitoring, when planning a staged rollout, or when you need a rollback strategy. | Stars: 118k | Updated | Claude CodeCodex | Verified | Install |
| childhoodthedotmack/claude-memBabysit a shipped release after merge, publication, or deployment. Verify published packages, production behavior, installed plugins, and late CI or user reports until the observation window is clean; use babysit for PR readiness before release. | Stars: 117k | Updated | Claude CodeCodex | Unverified | Install |