alphafold
/alphafold
Waliduje projekty białek przez przewidywanie struktury AlphaFold2: sprawdza fałdowanie, kompleksy oraz metryki pLDDT, pTM i ipTM.
- Autor
- ekko8600 ↗
- Repozytorium
- enzyme_design_harness ↗
- Licencja
- Apache-2.0
- Ostatnia zmiana repozytorium
- 08.11.2026
Ocena i bezpieczeństwo
- Pliki w paczce
- 13
- Skrypty
- 5
- Komentarze HTML
- 0
- Adresy URL w SKILL.md
- 1
Brak sygnałów. Repozytorium zmienione 08.11.2026, bez odwołań do wycofanych modeli i API.
Apache-2.0, otwarta: można używać i zmieniać, z zachowaniem licencji i informacji o zmianach.
- 5 skryptów w paczce. Przejrzyj je przed instalacją, bo Claude może je uruchomić.
Skrypty: scripts/local_alphafold.py, scripts/local_colabfold.py, scripts/offline_colabfold_driver.py, scripts/select_structure.py, scripts/validate_prediction.py
Co robi i kiedy
Waliduje projekty białek przez przewidywanie struktury AlphaFold2: sprawdza fałdowanie, kompleksy oraz metryki pLDDT, pTM i ipTM.
Oryginalny opis (EN)
Validate protein designs using AlphaFold2 structure prediction. Use this skill when: (1) Validating designed sequences fold correctly, (2) Predicting binder-target complex structures, (3) Calculating confidence metrics (pLDDT, pTM, ipTM), (4) Self-consistency validation of designs, (5) Multi-chain complex prediction with AlphaFold-Multimer. For faster single-chain prediction, use esm. For QC thresholds, use protein-qc.
Jak działa
- Prerequisites
- How to run
- Key parameters
- Output format
- Sample output
- Decision tree
- Typical performance
- Verify
- Troubleshooting
- Task harness handoff
Podgląd SKILL.md
---
name: alphafold
description: 'Validate protein designs using AlphaFold2 structure prediction. Use
this skill when: (1) Validating designed sequences fold correctly, (2) Predicting
binder-target complex structures, (3) Calculating confidence metrics (pLDDT, pTM,
ipTM), (4) Self-consistency validation of designs, (5) Multi-chain complex prediction
with AlphaFold-Multimer.
For faster single-chain prediction, use esm. For QC thresholds, use protein-qc.
'
metadata:
category: structure
tags: structure-prediction, validation, reference
local_script: scripts/local_colabfold.py
legacy_category: design-tools
taxonomy_version: enzyme-agent/taxonomy/v1
capability_ids:
- structure.analysis
---
# AlphaFold2 Structure Validation
## Prerequisites
| Requirement | Minimum | Recommended |
|-------------|---------|-------------|
| Python | 3.8+ | 3.10 |
| CUDA | 11.0+ | 12.0+ |
| GPU VRAM | 32GB | 40GB (A100) |
| RAM | 32GB | 64GB |
| Disk | 100GB | 500GB (for databases) |
## How to run
### Validate an existing prediction
Use the registered `validate_prediction` operation to compare a model PDB's
complete residue sequence with its frozen FASTA and check every pLDDT and PAE
value plus pTM range. For a named substitution, also provide the parent FASTA;
the receipt maps the mutation back to the PDB chain and residue number. These
checks establish sequence and data integrity only, not fold correctness or
enzyme activity.
> **First time?** Install the local model package for this tool and use the bundled local wrapper in the `scripts/` directory. No cloud account is required.
### Option 1: ColabFold (recommended for multimer)
```bash
enzyme-core run alphafold --work-dir ./runs/alphafold --operation local_colabfold -- \
--input-faa sequences.fasta \
--out-dir output/
```
**GPU**: A100 (40GB) | **Timeout**: 3600s default
### Option 2: Local installation
```bash
git clone https://github.com/deepmind/alphafold.git
cd alphafold
python run_alphafold.py \
--fasta_paths=query.fasta \
--output_dir=output/ \
--model_preset=monomer \
--max_template_date=2026-01-01
```
### Option 3: ESMFold (fast single-chain)
This OpenCode package does not bundle a local ESMFold wrapper. Use the bundled
ColabFold wrapper above for structure validation, or add an ESMFold wrapper to
`scripts/` before running ESMFold-specific commands.
## Key parameters
| Parameter | Default | Options | Description |
|-----------|---------|---------|-------------|
| `--model_preset` | monomer | monomer/multimer | Model type |
| `--num_recycle` | 3 | 1-20 | Recycling iterations |
| `--max_template_date` | - | YYYY-MM-DD | Template cutoff |
| `--use_templates` | True | True/False | Use template search |
## Output format
```
output/
├── ranked_0.pdb # Best model
├── ranked_1.pdb # Second best
├── ranking_debug.json # Confidence scores
├── result_model_1.pkl # Full results
├── msas/ # MSA files
└── features.pkl # Input features
```
### Extracting metrics
```python
import pickle
with open('result_model_1.pkl', 'rb') as f:
result = pickle.load(f)
plddt = result['plddt']
ptm = result['ptm']
iptm = result.get('iptm', None) # Multimer only
pae = result['predicted_aligned_error']
```
## Sample output
### Successful run
```
$ python run_alphafold.py --fasta_paths complex.fasta --model_preset multimer
[INFO] Running MSA search...
[INFO] Running model 1/5...
[INFO] Running model 5/5...
[INFO] Relaxing structures...
Results:
ranked_0.pdb:
pLDDT: 87.3 (mean)
pTM: 0.78
ipTM: 0.62
PAE (interface): 8.5
Saved to output/
```
**What good output looks like:**
- pLDDT: > 85 (mean, on 0-100 scale) or > 0.85 (normalized)
- pTM: > 0.70
- ipTM: > 0.50 for complexes
- PAE_interface: < 10
## Decision tree
```
Should I use AlphaFold?
│
├─ What are you predicting?
│ ├─ Single protein → ESMFold (faster)
│ ├─ Protein-protein complex → AlphaFold/ColabFold ✓
│ ├─ Protein + ligand → Chai or Boltz
│ └─ Batch of sequences → ColabFold ✓
│
├─ What do you need?
│ ├─ Highest accuracy → AlphaFold/ColabFold ✓
│ ├─ Fast screening → ESMFold
│ └─ MSA-free prediction → Chai or ESMFold
│
└─ Which AF2 option?
├─ Local installation → Full control, slow setup
├─ ColabFold → Easier, MSA server
└─ local GPU → Recommended for batch
```
## Typical performance
| Campaign Size | Time (A100) | Compute requirement | Notes |
|---------------|-------------|--------------|-------|
| 100 complexes | 1-2h | ~$8 | With MSA server |
| 500 complexes | 5-10h | ~$40 | Standard campaign |
| 1000 complexes | 10-20h | ~$80 | Large campaign |
**Per-complex**: ~30-60s with MSA server.
---
## Verify
```bash
find output -name "ranked_0.pdb" | wc -l # Should match input count
```
---
## Troubleshooting
**Low pLDDT regions**: May indicate disorder or poor design
**Low ipTM**: Interface not confident, check hotspots
**High PAE off-diagonal**: Chains may not interact
**OOM errors**: Use ColabFold with MSA server instead
### Error interpretation
| Error | Cause | Fix |
|-------|-------|-----|
| `RuntimeError: CUDA out of memory` | Sequence too long | Use A100 or split prediction |
| `KeyError: 'iptm'` | Running monomer on complex | Use multimer preset |
| `FileNotFoundError: database` | Missing MSA databases | Use ColabFold MSA server |
| `TimeoutError` | MSA search slow | Reduce num_recycles |
---
**Next**: `protein-qc` for filtering and ranking.
## Task harness handoff
The local wrappers write `OUT_DIR/RUN_NAME/manifest.json`, listing every produced PDB and confidence JSON with exact hashes and the input FASTA hash. This manifest does not scientifically rank or approve the structures.
After a Host decision checkpoint, call `select_structure --manifest manifest.json --candidate EXACT_RECORDED_PATH --output selected.pdb --provenance selection.json`. It validates the explicit candidate hash and exports a stable artifact for downstream MD. Sequence/residue identity, confidence, cofactors and simulation applicability still require scientific assessment.
Pliki w paczce (13)
- SKILL.md 6 KB
- execution_profile.json 2 KB
- scientific_contract.yaml 1 KB
- stability_evidence.json 1 KB
- agents/openai.yaml 1 KB
- fixtures/stability/invalid.json 1 KB
- fixtures/stability/valid.json 1 KB
- references/multimer.md 3 KB
- scripts/local_alphafold.py 3 KB
- scripts/local_colabfold.py 6 KB
- scripts/offline_colabfold_driver.py 2 KB
- scripts/select_structure.py 2 KB
- scripts/validate_prediction.py 6 KB
Wersje
| Repozytorium | Wynik | Licencja |
|---|---|---|
| Ta strona · ekko8600/enzyme_design_harness | 100 | Apache-2.0 |
| lamm-mit/scienceclaw | 100 | Apache-2.0 |
| FreedomIntelligence/OpenClaw-Medical-Skills | 100 | MIT |
| adaptyvbio/protein-design-skills | 100 | MIT |
Migawka bazy z 13.11.2026 · wersja paczki d4ea1ea1e433 (skrót SHA-256 całej paczki)
Pobrania w ostatnich 30 dniach: 0 · ranking
Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.
Podobne skille
- 100alterlab-alphafold
Przewiduje struktury 3D białek i kompleksów AlphaFold2 przez ColabFold oraz ocenia ich pewność metrykami pLDDT, pTM, ipTM i PAE. - 100chai
Przewiduje struktury białek i ich połączeń modelem Chai-1, także przez API, do walidacji projektowanych białek wiążących. - 100boltz
Przewiduje struktury za pomocą otwartego predyktora Boltz-1 i Boltz-2: kompleksy białek, walidację zaprojektowanych białek wiążących i kompleksy białko-ligand na lokalnym GPU. - 100alphafold-db
Pobiera z bazy AlphaFold DB przewidziane struktury 3D białek w formatach PDB i mmCIF, metryki pewności pLDDT i PAE oraz metadane według numeru UniProt. - 100chai
Przewiduje struktury kompleksów białko-białko i białko-ligand modelem Chai-1, waliduje zaprojektowane białka wiążące i obsługuje przewidywania wsadowe przez API jako alternatywa dla AlphaFold2. - 100alterlab-alphafold-db
Pobiera przewidywane struktury białek z bazy AlphaFold DB po identyfikatorze UniProt i analizuje metryki pewności pLDDT oraz PAE.