AlphaProtein Novo: generative diffusion pipeline for de novo enzyme design Google DeepMind released AlphaProtein Novo (AP Novo), a generative diffusion pipeline for de novo enzyme design via structural motif scaffolding that co-generates protein structures and sequences conditioned on a catalytic motif and ligand context. The package combines the diffusion model with optional LigandMPNN sequence redesign, AlphaFold 3 structure prediction, and evaluation metrics, orchestrated by run_pipeline.py, and requires pretrained generator weights (generator.bin.zst) downloaded separately from Google Cloud Storage under a separate terms-of-use agreement. Findings from the code, model parameters, or outputs must cite the bioRxiv paper "Designing enzymes for new-to-nature chemistry and non-natural substrates with AlphaProtein Novo. AlphaProtein Novo AP Novo is a generative diffusion pipeline for de novo enzyme design via structural motif scaffolding. This package includes a diffusion model which co-generates protein structures and sequences conditioned on a catalytic motif and ligand context. This is run using run generator.py . To form an end-to-end pipeline, the diffusion model is combined with optional sequence redesign using LigandMPNN run ligandmpnn.py , structure prediction using AlphaFold 3 run alphafold.py , and evaluation metrics evaluate design.py . The run pipeline.py script runs all stages in sequence. See the Quickstart quickstart section for a basic launch command and Example Design Campaigns example-design-campaigns for more detailed examples. Any publication that discloses findings arising from using this source code, the model parameters, or outputs produced by those should cite citing-this-work the Designing enzymes for new-to-nature chemistry and non-natural substrates with AlphaProtein Novo https://www.biorxiv.org/content/10.64898/2026.10.01.756017v1 paper. πŸ“’ Note: Pretrained model weights are not part of this package and must be downloaded from Google Cloud Storage see Model Parameters model-parameters-weights below . Use is subject to these terms of use https://github.com/google-deepmind/alphaprotein-novo/blob/main/WEIGHTS TERMS OF USE.md . Scripts look for weights under ./models/apnovo generator by default, or you can point to another directory using --apn model dir for run pipeline.py , --model dir for run generator.py , or settings.model dir in your design manifest. Two Python environments are recommended: - Primary Environment alphaprotein novo : Contains JAX. Runs diffusion generation, AlphaFold 3 folding, evaluation metrics, and the pipeline orchestrator. - LigandMPNN Environment ligandmpnn Optional : Contains PyTorch. Used to run LigandMPNN for sequence design. Create and activate a Python 3.12 environment uv venv --python 3.12 .venv source .venv/bin/activate Install JAX with CUDA 12 support or CPU: uv pip install -U jax uv pip install -U "jax cuda12 =0.4.30" Install AlphaFold 3 uv pip install git+https://github.com/google-deepmind/alphafold3.git Install AP Novo in editable mode cd /path/to/alphaprotein novo uv pip install -e . Compile AlphaFold 3 chemical component data CCD pickle build data πŸ“’ Tip: build data compiles ccd.pickle and chemical component sets.pickle required by AlphaFold 3 to parse ligands. If components.cif cannot be located, set the LIBCIFPP DATA DIR environment variable to its directory before running build data . Only required if you plan to run optional sequence redesign with LigandMPNN: 1. Create and activate Python 3.11 environment uv venv --python 3.11 .venv-ligandmpnn source .venv-ligandmpnn/bin/activate 2. Clone LigandMPNN and download weights git clone https://github.com/dauparas/LigandMPNN.git cd LigandMPNN bash get model params.sh ./model params 3. Install dependencies uv pip install -r requirements.txt uv pip install "setuptools<82" ProDy requires pkg resources removed in setuptools 82+ 4. Optional Set environment variables. This allows you to avoid having to provide the --ligandmpnn dir and --ligandmpnn python flags to run pipeline.py. export LIGANDMPNN DIR=/home/