v1.2.2

ColabFold MSA server (api.colabfold.com)

aipoch@aipoch⭐ 5.5k stars· last commit 9h ago· 17 open issues

>

Choose how to use this skill

You do not need every option. Choose the path your AI client supports. The stable page stays the same; versioned files are immutable.

1. Native installer

This listing has no registered native installer command. Use the complete package or source fallback below, depending on what your client supports.

Do not guess an installer command or replace an existing version without reviewing the diff.

2. Complete package recommended

Download the ZIP when available. It includes SKILL.md plus the references, security notes and version metadata.

No complete ProSkills package is published for this listing yet.

3. Prompt-only

Copy the prompt above when the agent can read the stable page or when you want to adopt the workflow without installing a skill.

Need only the instruction file?

Download SKILL.md only if your client requires a single file. The complete ZIP is safer for a full installation because it preserves the references and release context.

No path installs or executes anything by itself. Your agent still needs access to the project files. Before updating, compare the installed version and review the diff.

7.5/10
Verified
Oct 11, 2026

// RATINGS

⭐GitHub Stars
⭐⭐⭐⭐⭐ 5.5k on GitHubGitHub ↗

Very popular

🟢ProSkills ScoreAI Verified
7.5/10
📍

Not yet listed on ClawHub or SkillsMP

// README

💡 AIPOCH Open-Science v1.2.2 updates

November 12, 2026

  • Strict network mode: Opt in to a Strict whitelist for Notebook networking — requests must match your rules by protocol, host, and port; unmatched requests are blocked without an authorization prompt.
  • Films resume: Interrupted research-film generation continues from validated checkpoints with a five-step progress view; completed scenes and narration are reused.
  • PDF fidelity: External PDFs keep native figures, tables, captions, and reading order, and translated documents preserve the original structure and layout.
  • Safer Windows grants: Folder grants in protected mode are checked before saving, and update, uninstall, and handoff flows recover more reliably with diagnostics preserved.
  • Provider updates: Qwen4 Max Preview joins Bailian Token Plans in Beijing and Singapore, and default models for official connections are refreshed.
  • Reliability fixes: Session imports report their outcome, service recovery blocks the workspace until the connection returns, and dark-mode contrast is preserved across surfaces.

View the full v1.2.2 release notes

A research record to share, a film to watch

Hand off a result with a .science package. Export the conversation branches, file versions, Notebook records, and verification evidence you want to share. Recipients can import the package into their own projects, open the read-only record, and trace a figure or table back to its inputs. Verification records describe the sender’s checks. In the desktop app, Fork to continue creates a writable copy.

Present the same work as a Research Film. In the desktop app, choose Generate research film on a completed conversation branch. Your configured model prepares the presentation from the recorded session, and the local speech engine generates English narration. Review the film, then download the HTML player or export an MP4. A .science package can also carry the player for a film already generated on an included branch.

🚀 Quick Start

1. Download the app

Open the official download page and choose the installer for your computer:

Your computerChoose
macOS 12+ — Apple Silicon (M1 or newer)The macOS DMG for Apple Silicon / ARM64
macOS 12+ — IntelThe macOS DMG for Intel / x64
Windows 10/11 x64The Windows x64 installer (code-signed)
Linux x64The Linux x64 AppImage or Debian package
Linux ARM64The Linux ARM64 AppImage or Debian package

See download verification for checks before installation.

On macOS, you can also install with Homebrew:

brew install --cask open-science

The release assets include standalone CLI archives for macOS, Linux, and Windows. They bundle Node.js, so you can run the CLI without installing Node.js, npm, or Homebrew.

For the standalone CLI on macOS or Linux, use the separate AIPOCH tap:

brew install aipoch/tap/open-science

This Formula includes Node and runs without the desktop app; its release may differ from the desktop Cask. See the standalone runtime guide for prerequisites and upgrades.

For the standalone CLI and Web UI, install the published npm package with Node.js 22.13.0 or later:

npm install --global @aipoch/open-science
open-science start --no-open
open-science url

Open the printed URL to complete setup, or follow the terminal setup guide. npm supports macOS ARM64/x64, glibc Linux ARM64/x64 and Windows x64; the desktop app is not required. Keep npm optional dependencies enabled and review the Linux prerequisites and upgrade instructions. The URL contains an authentication token; keep it private.

Windows reinstalls preserve research data. For a full cleanup, see the data reset tool, which permanently deletes local data after confirmation.

2. Complete first-time setup

F

// HOW IT'S BUILT

// FILES

3 files shipped with this skill. Inline text is the catalog copy. The upstream link is the source repository.

  • resources/skills/alphafold2/SKILL.md5.3 KB486fe3264eb5upstream ↗
    ---
    name: alphafold2
    description: >
      Predict protein structure for monomers and multimers with AlphaFold2 via the
      ColabFold runner (Mirdita et al. 2022, github.com/sokrypton/ColabFold;
      AlphaFold2 Jumper et al. 2021). Reach for this skill to fold a sequence or
      complex with the AF2/AF2-Multimer evoformer, to validate designed sequences
      by self-consistency pLDDT, ipTM, and RMSD, or to run a quick MSA-backed
      prediction using the public MMseqs2 server.
    license: Apache-2.0
    category: biomodels
    requirements: [gpu]
    metadata:
      display-name: AlphaFold2
      # README #model-parameters-license: "AlphaFold parameters … CC BY 4.0".
      # SKILL.md body: "the public MMseqs2 server" (api.colabfold.com — user's
      # sequence is POSTed there for MSA). verified 2026-06-30
      third_party:
        - kind: weights
          name: AlphaFold2
          provider: Google DeepMind
          license: CC-BY-4.0
          terms_url: https://github.com/google-deepmind/alphafold#model-parameters-license
        # api.colabfold.com has no published ToS or privacy policy. The GitHub
        # wiki is the closest data-use reference (info_url, not terms_url).
        # Hostname in `name` so the user sees exactly where their sequence goes.
        - kind: service
          name: ColabFold MSA server (api.colabfold.com)
          provider: Steinegger Lab
          info_url: https://github.com/sokrypton/ColabFold/wiki
    ---
    
    # AlphaFold2 (ColabFold runner)
    
    This skill wraps AlphaFold2 and AlphaFold2-Multimer through `colabfold_batch`,
    which replaces DeepMind's local-database MSA pipeline with a call to the public
    MMseqs2 server — so a prediction is one command and one FASTA, not a 2 TB
    database mount. AF2 remains the reference monomer predictor and the multimer
    model is still a strong protein–protein validator, but it does not handle
    ligands or nucleic acids; for those, route to `boltz`, `chai1`, or `openfold3`.
    The ColabFold code is MIT (github.com/sokrypton/ColabFold) and the AlphaFold2
    code is Apache-2.0 (github.com/google-deepmind/alphafold); the AF2 model
    parameters are CC-BY-4.0 with DeepMind's terms of use.
    
    ## Running it
    
    ```bash
    colabfold_batch input.fasta out \
      --num-recycle 3 \
      --model-type alphafold2_multimer_v3
    ```
    
    The input is a plain FASTA. For a complex, put every chain on one sequence
    line separated by `:` — `colabfold_batch` builds a paired MSA per segment and
    runs the multimer model when it sees the colon (so the explicit `--model-type
    alphafold2_multimer_v3` above is belt-and-braces). For monomers omit
    `--model-type` and the colon. `--templates` and `--amber` add PDB templates
    and OpenMM relaxation respectively; both are off by default and both add
    minutes per model.
    
    ColabFold runs all five AF2 model weights by default and ranks them by pLDDT
    (pTM/ipTM for multimer), so output per query lands in `out/` as five ranked
    PDBs `<name>_unrelaxed_rank_00{1..5}_*.pdb` (b-factor column carries pLDDT)
    and a matching `<name>_scores_rank_00{N}_*.json` with `plddt`, `ptm`, and — for
    multimer — `iptm` and the `pae` matrix. Rank-1 is the model to read first;
    ipTM > 0.5 is the usual soft pass for an interface.
    
    ## Unified-memory defaults loop forever under gVisor — the env patches them out
    
    `colabfold/batch.py` hard-sets `TF_FORCE_UNIFIED_MEMORY=1` and
    `XLA_PYTHON_CLIENT_MEM_FRACTION=4.0` on import. Under a gVisor sandbox unified
    memory is unsupported, so JAX's `device_put` loops indefinitely allocating
    host RAM during AF2 parameter load — the job appears hung, never errors.
    Override both before the import (`TF_FORCE_UNIFIED_MEMORY=0`, fraction
    `0.95`), or `sed`-patch the two assignments out of `batch.py` in the image
    build, or the first fold never starts.
    
    ## The MSA server is the wall-clock bottleneck, and it is shared
    
    `colabfold_batch` defaults to `--msa-mode mmseqs2_uniref_env`, which posts your
    sequence to `api.colabfold.com`. That server is a public, rate-limited
    resource: the wait dominates short folds and occasionally times out under load.
    For campaigns, run the MSA stage once with `--msa-only`, keep the resulting
    `.a3m` files, and feed the directory back as the input on subsequent runs — the
    GPU stage then starts immediately and the server is not hit again.
    
    ## Errors worth recognizing
    
    | You see                                                            | It means / do this                                                                                                 |
    | ------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------ |
    | Job hangs silently during "Running model_1" with host RAM climbing | Unified-memory loop under gVisor — see the gotcha above; override or patch `batch.py`.                             |
    | `RESOURCE_EXHAUSTED` / OOM during XLA compile                      | `XLA_PYTHON_CLIENT_MEM_FRACTION` too high for the GPU — drop below the `0.95` default to `0.9` or so.              |
    | MSA stage hangs at `Submitting job`                                | Public MMseqs2 server is rate-limiting — wait, or pre-compute with `--msa-only` and re-run from the cached `.a3m`. |
    
    ---
    
    **Next:** for designed-sequence validation, superpose the rank-1 model onto
    the design backbone with US-align and gate on pLDDT/ipTM thresholds; for
    ligand-bearing complexes, hand the same chains to `boltz` or `chai1`.
    
  • resources/skills/alphafold2/.catalog_stamp13 B267b449ac7afupstream ↗
    1782943770000
  • README.mdupstream ↗

    Contents are not inlined in the catalog. Open the upstream file.

Plain-text copy, no login: /skill-bundles/aipoch-open-science-resources-skills-alphafold2.md

// REPO STATS

5.5k stars
17 open issues
Last commit: 9h ago