openfold2-nim
Use this skill for OpenFold2, NVIDIA's BioNeMo NIM microservice for monomer protein structure prediction. Invoke whenever the user mentions OpenFold2, AlphaFold2-like monomer folding, protein sequence-to-structure prediction, A3M MSAs, mmCIF templates, hosted NVIDIA API calls, or local Docker deploy…
Install / Use
npx skills add NVIDIA/skills --skill bionemo-openfold2-nimInstalls into whichever agent you are using.
SKILL.md
Installable skill definition
Quality Score
Category
OperationsSupported Platforms
Our assessment of openfold2-nim
openfold2-nim scores 90/100 on our quality scale, 310th of 745 Operations skills we index (top 42%).
Its SKILL.md is 7.0 KB long, split into 7 sections with 3 code examples: a thorough specification that gives an agent plenty to work with.
With 3,421 GitHub stars, it is one of the more widely adopted skills in the catalogue.
Maintenance, license and trust
- The repository was last updated about 2 months ago, so openfold2-nim is actively maintained.
- Our last check on 2026-10-30 found the source still online.
- It is released under the Apache-2.0 license, a permissive license that allows use, modification and commercial use with attribution.
- Its trust signals score 100/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
Safety scan
No issues foundOur scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.
AI review by kimi-k2.7-code on 2026-09-29. Automated pattern scan on 2026-09-29. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.
openfold2-nim compared with similar skills
All 4 of these similar skills score higher than openfold2-nim; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| openfold2-nim (this skill)by NVIDIA | 90 | 3.4k | 54d ago | SKILL.md |
| Agent-Reachby Panniantong | 100 | 112.3k | 8d ago | CLAUDE.md |
| headroomby headroomlabs-ai | 100 | 79.8k | today | CLAUDE.md |
| Scraplingby D4Vinci | 100 | 103.6k | 2d ago | MCP Server |
| crawl4aiby unclecode | 100 | 87.4k | 3d ago | MCP Server |
Frequently asked questions
- How do I install openfold2-nim?
- Run
npx skills add NVIDIA/skills --skill openfold2-nim. The install tabs above show the steps for each supported agent. - Which AI agents does openfold2-nim work with?
- It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
- Is openfold2-nim safe to use?
- Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It is Apache-2.0-licensed and scores 100/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is openfold2-nim still maintained?
- The repository was last updated about 2 months ago, so openfold2-nim is actively maintained.
Skill content
View source on GitHubname: openfold2-nim description: > Use this skill for OpenFold2, NVIDIA's BioNeMo NIM microservice for monomer protein structure prediction. Invoke whenever the user mentions OpenFold2, AlphaFold2-like monomer folding, protein sequence-to-structure prediction, A3M MSAs, mmCIF templates, hosted NVIDIA API calls, or local Docker deployment. license: Apache-2.0 AND CC-BY-4.0 compatibility: "requests>=2.28" allowed-tools: Bash, Read, Write, AskUserQuestion
OpenFold2 NIM
Predict a single protein-chain structure from an amino-acid sequence, with optional A3M multiple sequence alignments and mmCIF templates. Use this guide for basic hosted/local NIM use; load supplemental files only when the task needs deeper context:
references/api.md: exact endpoints, schemas, Docker flags, response fields.references/science.md: model scope, strengths, limitations, and handoffs.references/parameters.md: MSA, template, model-selection, and relax effects.references/validation.md: artifact and scientific sanity checks.references/examples.md: compact hosted/local payload patterns.
Choose Mode
Ask only when context is unclear:
Hosted NVIDIA API or local Docker NIM?
- Hosted URL:
https://health.api.nvidia.com/v1/biology/openfold/openfold2/predict-structure-from-msa-and-template - Local URL:
http://localhost:8000/biology/openfold/openfold2/predict-structure-from-msa-and-template - Local readiness:
http://localhost:8000/v1/health/ready
Mode difference: hosted and local use the same prediction path except local
does not include /v1/. Hosted requests use Authorization: Bearer $NGC_API_KEY; local inference requests use no auth header after readiness.
Auth And Environment
Do not print API keys. Confirm they exist with shell tests, not echoes.
Hosted needs NGC_API_KEY in the request header. Supported local Docker
startup uses NGC_API_KEY, or NVIDIA_API_KEY as a fallback, plus
LOCAL_NIM_CACHE. A repo-root .env file may be sourced as a local override.
Local Docker
Use the official OpenFold2 NIM image and mount LOCAL_NIM_CACHE at
/opt/nim/.cache. Current docs recommend at least 80 GB disk, 64 GB system
RAM, 8 CPU cores, and one supported GPU; the container is roughly 55 GB and
first startup downloads about 10 GB of model parameters.
For the exact startup preflight (.env sourcing, NGC_API_KEY/NVIDIA_API_KEY
handling, docker login, and the docker run for
nvcr.io/nim/openfold/openfold2:latest), copy the command block in
references/api.md under Local Docker verbatim — do
not drop .env, NGC_API_KEY, LOCAL_NIM_CACHE, or the no-auth local request.
Readiness check:
until curl -sf http://localhost:8000/v1/health/ready; do sleep 5; done
Request Pattern
Use Python requests; curl escaping is fragile for A3M/mmCIF text. The
sequence field is required. input_id, alignments, selected_models,
relax_prediction, use_templates, and explicit_templates are optional.
import os
import requests
hosted = True
url = (
"https://health.api.nvidia.com/v1/biology/openfold/openfold2/predict-structure-from-msa-and-template"
if hosted
else "http://localhost:8000/biology/openfold/openfold2/predict-structure-from-msa-and-template"
)
headers = {"Content-Type": "application/json"}
if hosted:
headers["Authorization"] = f"Bearer {os.getenv('NGC_API_KEY')}"
seq = "MTEYKLVVVGAGGVGKSALTIQLIQNHFVDEYDPT"
payload = {
"sequence": seq,
"input_id": "kras_fragment",
"selected_models": [1],
"relax_prediction": False,
"alignments": {
"uniref90": {
"a3m": {
"alignment": f">query\n{seq}",
"format": "a3m",
}
}
},
}
response = requests.post(url, headers=headers, json=payload, timeout=300)
response.raise_for_status()
result = response.json()
Payload gotchas:
- OpenFold2 is monomer-only. For protein-ligand, protein-DNA/RNA, or multi-chain complexes, use OpenFold3 or Boltz2 instead.
sequencemust use valid amino-acid IUPAC symbols.- Hosted API docs list sequence length 1-1000; local docs say current NIM supports sequences up to 2048 residues on supported hardware.
- A3M alignments go under
alignmentsby database name, thena3mwithalignmentandformat. When the user needs to create or deepen an MSA, hand off tomsa-search-nim/ MSA Search and map its A3M output into thisalignmentsshape. - Starting with OpenFold2 2.0.0, use
explicit_templateswith mmCIF content; do not write new HHR-template examples. selected_modelschooses AlphaFold2/OpenFold parameter sets 1-5. Select one or two models for smoke tests; use all five for stronger production runs.
Save And Interpret Output
The response includes one prediction per selected model, ordered by confidence.
Save every returned structure-like text field and the full JSON response so
field-shape differences are auditable. Production answers should explicitly
write .pdb or .cif artifacts, preserve the response JSON, and print any
confidence/ranking fields the service returns.
from pathlib import Path
import json
Path("openfold2_response.json").write_text(json.dumps(result, indent=2))
def save_strings(obj, prefix="openfold2"):
i = 0
if isinstance(obj, dict):
for key, value in obj.items():
if isinstance(value, str) and ("ATOM" in value or value.lstrip().startswith("data_")):
i += 1
ext = "cif" if value.lstrip().startswith("data_") else "pdb"
Path(f"{prefix}_{key}_{i}.{ext}").write_text(value)
elif isinstance(value, (dict, list)):
i += save_strings(value, f"{prefix}_{key}")
elif isinstance(obj, list):
for idx, value in enumerate(obj, start=1):
if isinstance(value, (dict, list)):
i += save_strings(value, f"{prefix}_{idx}")
return i
saved = save_strings(result)
print(f"saved {saved} structure artifact(s)")
For production monomer runs:
- Use
selected_models: [1, 2, 3, 4, 5]unless the user requests a smoke test. - Use
relax_prediction: Truein Python payloads when relaxation is desired; JSON examples may showtrue. - State the sequence length caveat: hosted API docs list 1-1000 residues, while local support-matrix docs list up to 2048 residues on supported hardware.
- If the task is a complex rather than a monomer, redirect to OpenFold3 or Boltz2.
Treat tiny toy sequences and single-sequence MSAs as API smoke tests, not
quality evidence. For scientific interpretation and validation, read
references/science.md and references/validation.md.
Troubleshooting
401: missing, expired, or unauthorized NGC API key.422: invalid amino-acid characters, sequence too long, malformed A3M, badselected_models, or malformed mmCIF template object.- Local
404: remove/v1/from the prediction URL. - Weak structures: use MSA Search to generate deeper A3M alignments and add biologically relevant mmCIF templates when appropriate.
- Local startup stalls: first run downloads parameters into
LOCAL_NIM_CACHE.
Related Skills
Agent-Reach
112.3kGive your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.
headroom
79.8kCompress tool outputs, logs, files, and RAG chunks before they reach the LLM. 20% fewer tokens for coding agents, 60-95% fewer tokens for JSON, same answers. Library, proxy, MCP server.
Scrapling
103.6k🕷️ The BEST Web Scraping framework that handles everything from a single request to a full-scale crawl! Don't be shy, join here: https://discord.gg/EMgGbDceNQ and follow here for daily tips and tricks: https://x.com/Scrapling_dev
crawl4ai
87.4kOfficial Crawl4AI Cloud: a hosted web scraping, extraction, and search API for AI agents. Free API key, 1,000 credits a month, no card. Fully open source: this repo is the Apache-2.0 crawler that powers it, and you can self-host it.
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
