Skip to content

Automate OpenFold & VizFold-Foundation HPC Setup (Fixes #5)#68

Open
JeevanandanRamasamy wants to merge 1 commit into
AI2Science:mainfrom
JeevanandanRamasamy:installation-fix
Open

Automate OpenFold & VizFold-Foundation HPC Setup (Fixes #5)#68
JeevanandanRamasamy wants to merge 1 commit into
AI2Science:mainfrom
JeevanandanRamasamy:installation-fix

Conversation

@JeevanandanRamasamy

@JeevanandanRamasamy JeevanandanRamasamy commented Apr 25, 2026

Copy link
Copy Markdown

Automate HPC Environment Setup & Dependency Resolution for PACE ICE (Fixes #5)

Context
This PR provides a reproducible, automated environment setup for the PACE ICE cluster. It handles the complex dependency resolution and CUDA extension builds required for OpenFold.

What's Included

  • Automated Installers: Added install.py (for interactive SLURM jobs) and install.ipynb (for JupyterLab) to automate the full environment setup, repository cloning, and dependency installation.
  • Pre-flight & Post-install Checks: The scripts automatically verify cluster requirements (GPU access, Conda, disk space, and AlphaFold data paths) before starting, and run a final verification step to confirm PyTorch, CUDA, and OpenFold imports work correctly.
  • Optimized Environment Resolution: Utilizes the libmamba solver for faster Conda dependency resolution and configures the environment specifically for PACE ICE compatibility.
  • README: Added setup documentation with clear, step-by-step instructions for both the Python script and Jupyter notebook installation paths.

Notes
This does not close every single requirement of Issue #5, but it resolves the core blocker of achieving reproducible environment setups on the ICE cluster.

Adds install.py and install.ipynb to automate OpenFold and VizFold-Foundation setup on PACE ICE (RHEL 9, CUDA 12.4, H100).
Key features:
- Pre-flight checks for GPU, conda, disk space, and AlphaFold data
- PACE ICE-compatible environment.yml (PyTorch 2.5.1, CUDA 12.4)
- libmamba solver for faster dependency resolution
- System GCC 12.3.0 + CUDA_HOME=$CONDA_PREFIX to avoid compiler
  and CUDA version mismatches during OpenFold build
- Safe re-runs: skips git clone and symlink creation if already done
- Post-install verification of PyTorch+CUDA, OpenFold, viz tools
- Updated README documenting both install methods and prerequisites
@JeevanandanRamasamy JeevanandanRamasamy changed the title Add robust installationGuide for OpenFold on PACE ICE Automate OpenFold & VizFold-Foundation HPC Setup (Fixes #5) Apr 25, 2026
@PranavNarala1

Copy link
Copy Markdown

I think this PR does a good job of making the setup process more usable instead of just adding a long list of dependencies. One thing I liked is that it supports both an interactive Python installer and a notebook-based installer, which makes the workflow more flexible depending on how someone is working on the cluster. I also thought the pre-checks and post-install validation were a strong addition, since those make it much easier to catch environment issues before someone spends a lot of time debugging later. One thing I would still suggest checking is how portable the environment file is outside this exact system setup. Since a lot of the changes seem tailored to PACE ICE, it might help to separate what is strictly required from what is mainly cluster-specific, and maybe include one short “minimum validation” step showing the first few commands a user should run after setup to confirm the environment is working correctly.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Setup & Explore the Codebase

2 participants