| name | protenix |
| description | Structure prediction with Protenix, an open AlphaFold3 reproduction. Use this skill when: (1) Predicting complex structures with an AF3-class model, (2) Wanting an open alternative to AF3 alongside Boltz and Chai, (3) Validating designed binder-target complexes.
For QC thresholds, use protein-qc. For ipSAE ranking, use ipsae.
|
| license | MIT |
| category | design-tools |
| tags | ["structure-prediction","validation","alphafold3","open-source"] |
| biomodals_script | modal_protenix.py |
Protenix Structure Prediction
Protenix is ByteDance's open PyTorch
reproduction of AlphaFold3 (Apache 2.0). It is an AF3-class complex predictor, useful
next to boltz and chai for cross-checking designed complexes. Runnable through
biomodals.
Use Protenix-v2 for antibody-antigen complexes. The v2 model (464M params, April
2026) adds 9 to 13 percentage points of antibody-antigen accuracy over v1 at the
DockQ > 0.23 threshold and is more sample-efficient (v2 at 5 seeds exceeds v1 at 1000).
Select it with --model-name protenix-v2. For general complexes, the v1 base model is
fine.
Prerequisites
| Requirement | Value |
|---|
| Runner | Modal (biomodals) |
| GPU | L40S (default; GPU env var) |
| Setup | See Getting started |
How to run
git clone https://github.com/hgbrian/biomodals && cd biomodals
printf '>protein|A\nMAWTPLLLLLLSHCTGSLSQ...\n' > target.faa
uv run --with modal modal run modal_protenix.py \
--input-faa target.faa \
--seeds 42 \
--no-use-msa
Key parameters
| Parameter | Default | Description |
|---|
--input-faa | one required | FASTA input (or --input-json) |
--seeds | 42 | Comma-separated seeds |
--use-msa / --no-use-msa | MSA on | Pass --no-use-msa for single-sequence |
--model-name | v1 base | Set protenix-v2 for antibody-antigen complexes |
--use-mini | off | Switch to the smaller protenix_mini model |
--out-dir | ./out/protenix | Output directory |
When to use Protenix vs Boltz vs Chai
| Need | Tool |
|---|
| Affinity head (small molecules) | boltz (Boltz-2) |
| Fastest, ligand support | chai |
| Open AF3 reproduction | protenix (v1 base) |
| Antibody-antigen complexes | protenix-v2 |
Ranking a shortlist across more than one predictor is more reliable than trusting a
single model.
Troubleshooting
| Issue | Cause | Fix |
|---|
| Missing input error | No --input-faa/--input-json | Provide one |
| Slow run | MSA enabled | Add --no-use-msa |
| OOM | Large complex | Use --use-mini or a larger GPU |
Next: Rank with ipsae, filter with protein-qc.
