rfdiffusion3

name

rfdiffusion3

description

Install, validate, teach, and run RosettaCommons Foundry/RFdiffusion3 workflows on a local or cluster Python/GPU environment. Use when the user mentions RFdiffusion3, RFD3, Foundry, rc-foundry, RF3, ProteinMPNN, LigandMPNN, checkpoint downloads, official RFD3 tutorials, RFD3 design JSON/YAML inputs, protein binders, nucleic-acid binders, small-molecule binders, enzyme scaffolds, partial diffusion, or asks to package/run/debug RFD3 jobs.

RFdiffusion3

Defaults

Use these paths unless the user gives different ones:

env_prefix=/path/to/conda-envs/foundry-py312
checkpoint_dir=/path/to/foundry/checkpoints
workspace=/path/to/foundry/workspace
run_root=/path/to/foundry/workspace/rfd3_runs
conda_pkgs_dir=/path/to/conda-pkgs
pip_cache_dir=/path/to/pip-cache

Prefer a dedicated Python 3.12 Foundry environment unless the user provides a different supported installation.

First Step

For any install/debug/run request, inspect the live state before making claims:

conda info --envs
nvidia-smi
test -d /path/to/conda-envs/foundry-py312
test -d /path/to/foundry/checkpoints

When running commands:

source ${CONDA_BASE:-$HOME/miniconda3}/etc/profile.d/conda.sh
conda activate /path/to/conda-envs/foundry-py312
export FOUNDRY_CHECKPOINT_DIRS=/path/to/foundry/checkpoints
mkdir -p /path/to/foundry/workspace/rfd3_runs

Validate

Use the bundled script before expensive GPU work:

python /path/to/foundry/workspace/skills/rfdiffusion3/scripts/check_foundry_env.py \
  --checkpoint-dir /path/to/foundry/checkpoints

For official demo smoke tests:

python /path/to/foundry/workspace/skills/rfdiffusion3/scripts/prepare_rfd3_demo.py \
  --workdir /path/to/foundry/workspace/rfd3_demo \
  --checkpoint-dir /path/to/foundry/checkpoints
cd /path/to/foundry/workspace/rfd3_demo/verify_installation
FOUNDRY_CHECKPOINT_DIRS=/path/to/foundry/checkpoints rfd3 design out_dir=demo_output inputs=demo_compat.json skip_existing=False prevalidate_inputs=True diffusion_batch_size=1 n_batches=1 low_memory_mode=True dump_trajectories=False

Use demo_compat.json for this machine's smoke test; the upstream demo file included an unsupported allow_ligand_on_existing_chain field for the installed package version.

Run RFD3

Minimum command:

FOUNDRY_CHECKPOINT_DIRS=/path/to/foundry/checkpoints rfd3 design out_dir=<out_dir> inputs=<input.json>

First-pass low-memory settings:

rfd3 design out_dir=<out_dir> inputs=<input.json> prevalidate_inputs=True skip_existing=False diffusion_batch_size=1 n_batches=1 low_memory_mode=True dump_trajectories=False

Before writing an input file, inspect the user's PDB/CIF for chain IDs, residue numbers, and ligand residue names. Prefer absolute input paths or paths relative to the run directory.

References

Read only the reference needed for the task:

• references/foundry-rfd3-workflow.md: installation, local path policy, checkpoints, and environment validation.
• references/rfd3-usage-workflows.md: official tutorial distilled workflows, input fields, templates for PPI, NA, small molecule, enzyme scaffold, and partial diffusion.
• references/foundry-postprocess-workflow.md: RFD3 outputs into ProteinMPNN/LigandMPNN, RF3 fold/review, Python API in-memory pipeline, and RMSD/QC.

User-facing tutorials live outside the skill:

• /path/to/foundry/workspace/RFdiffusion3_Foundry_安装教程.md
• /path/to/foundry/workspace/RFdiffusion3_使用教程.md
• /path/to/foundry/workspace/Foundry_RFD3_MPNN_RF3_后处理教程.md

Bundled scripts:

• scripts/check_foundry_env.py: validate Python, torch/CUDA, Foundry CLIs, and checkpoints.
• scripts/prepare_rfd3_demo.py: download official demo inputs and create demo_compat.json.
• scripts/prepare_rfd3_tutorial_assets.py: download official tutorial/example assets by profile when available.
• scripts/make_foundry_postprocess_case.py: generate an MPNN JSON config plus runnable MPNN/RF3 shell scripts for a chosen RFD3 structure.
• scripts/foundry_python_api_pipeline_demo.py: template for notebook-style in-memory RFD3 -> MPNN -> RF3 -> RMSD workflow.
• scripts/qc_foundry_backbone_rmsd.py: file-based backbone RMSD/QC between an RFD3 design and RF3 refolded structure.