alterlab-adaptyv
Submits and tracks protein-testing experiments on the Adaptyv Bio Foundry cloud lab (wet-lab validation), and optimizes protein sequences before submission with computational tools (NetSolP, SoluProt, SolubleMPNN, ESM). Use when designing proteins that need wet-lab validation - binding/affinity screening, expression testing, thermostability, or fluorescence assays - or when submitting experiments to the Foundry API, browsing the target catalog, tracking experiment status, retrieving results, or pre-screening sequences for solubility/expression. Triggers on "Adaptyv", "Foundry API", "cloud lab", "biolayer interferometry / BLI", "wet-lab validation". Part of the AlterLab Academic Skills suite.
How do I install this agent skill?
npx skills add https://github.com/alterlab-ieu/alterlab-academic-skills --skill alterlab-adaptyvIs this agent skill safe to install?
- Gen Agent Trust Hubpass
The skill provides a legitimate interface and optimization workflow for the Adaptyv Bio Foundry cloud lab. It follows security best practices for credential management and relies on well-known scientific libraries and academic web services. No malicious patterns were detected.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
What does this agent skill do?
Adaptyv
Adaptyv Bio runs the Foundry cloud lab: submit protein sequences and a target, the lab runs the assay, and you retrieve experimental data (binding/affinity, thermostability, expression, fluorescence). The public Foundry API drives the full lifecycle programmatically. Turnaround is on the order of weeks; confirm the current estimate from the per-experiment quote rather than assuming a fixed number.
The exact request/response shapes evolve. This skill captures the API contract as published in the OpenAPI doc (v0.0.2, checked 2026-09-23) at
https://foundry-api-public.adaptyvbio.com/api/v1/openapi.json; that spec listshttps://devs.adaptyvbio.comas the production base URL, and both hosts serve the same/api/v1routes. See alsohttps://docs.adaptyvbio.com.
When to Use This Skill
Use this skill to design → test → learn with Adaptyv's cloud lab: pick a catalog target, pre-screen and submit designed sequences, track experiments through quote and production, and pull binding, stability, expression, fluorescence, epitope-binning, or enzyme-activity data.
Does NOT Trigger
| Scenario | Use Instead |
|---|---|
| Designing sequences for a fixed backbone (inverse folding) before any wet-lab step | alterlab-proteinmpnn |
| Protein language-model embeddings or generative design with ESM3 / ESM C | alterlab-esm |
| Cell-free expression or other protocols on Ginkgo's cloud lab (RACs) | alterlab-ginkgo-cloud |
| Recording constructs, plasmids, and results in an ELN/LIMS | alterlab-benchling |
Prefer the official tooling first
Adaptyv ships its own integrations - reach for them before hand-rolling requests:
- Official Python SDK —
github.com/adaptyvbio/adaptyv-sdk(MIT). Decorator-based: wrap a design function with@lab.experiment(target=...); readsADAPTYV_API_KEY/ADAPTYV_API_URL(and optionalADAPTYV_ORGANIZATION_ID) from the environment. Install from source (pip install -e .after cloning — no PyPI release confirmed; verify before pinning). - Adaptyv's own Claude Code skills —
github.com/adaptyvbio/protein-design-skills. Useful prior art for protein-design + Foundry workflows.
Use this skill's raw-requests recipes when the SDK is unavailable or you need fine control over the lifecycle.
Quick Start
Authentication Setup
- Create a token in the Foundry portal:
https://foundry.adaptyvbio.com/→ Organization → Settings → Tokens (pick a role: Member = read/write, Viewer = read-only; set an expiry). The token value is shown only once — copy it immediately. - Set it in your environment (never commit it):
export ADAPTYV_API_KEY="your_token_here"
Or put it in a gitignored .env:
ADAPTYV_API_KEY=your_token_here
Installation
If using the raw API directly:
uv pip install requests python-dotenv
Basic Usage
The API uses a draft → submit → confirm quote flow: create an experiment (it starts as draft), submit it (Adaptyv then generates a quote asynchronously; status waiting_for_confirmation), and confirm the quote to create the invoice. sequences is a {label: amino_acid_string} map (values may also be objects such as {"aa_string": "...", "control": true}; multi-chain constructs join chains with a colon, e.g. "heavy:light").
import os
import requests
from dotenv import load_dotenv
load_dotenv()
api_key = os.getenv("ADAPTYV_API_KEY")
base_url = "https://foundry-api-public.adaptyvbio.com/api/v1"
headers = {
"Authorization": f"Bearer {api_key}",
"Content-Type": "application/json",
}
# 1. Create a draft experiment
resp = requests.post(
f"{base_url}/experiments",
headers=headers,
json={
"name": "mini-binder round 1",
"experiment_spec": {
"experiment_type": "affinity", # screening|affinity|thermostability|fluorescence|expression|epitope_binning|enzyme_activity
"method": "bli", # bli|spr (for binding-type assays)
"target_id": "<target uuid from GET /targets>",
"sequences": {
"design_a": "MKVLWALLGLLGAA...",
"design_b": "MATGVLWALLG...",
},
},
},
)
resp.raise_for_status()
experiment_id = resp.json()["experiment_id"]
# 2. Submit the reviewed draft; the quote is generated asynchronously afterwards
requests.post(f"{base_url}/experiments/{experiment_id}/submit", headers=headers).raise_for_status()
# 3. Poll GET /experiments/{id}/quote until it exists, review totals/expiry, then accept it
# (creates the invoice; the JSON body is required even when empty)
quote = requests.get(f"{base_url}/experiments/{experiment_id}/quote", headers=headers)
requests.post(f"{base_url}/experiments/{experiment_id}/quote/confirm",
headers=headers, json={}).raise_for_status()
Available Experiment Types
Foundry supports these experiment_type values:
- screening - Binding detection via biolayer interferometry (BLI) or SPR. Requires a target.
- affinity - Kinetic constants (KD, kon, koff) by BLI/SPR. Requires a target.
- thermostability - Melting temperature (Tm) via DSF. No target required.
- fluorescence - Fluorescence intensity. No target required.
- expression - Protein yield quantification. No target required.
- epitope_binning - Epitope grouping of binders; requires a target and 4–28 sequences in multiples of 4.
- enzyme_activity - Enzyme activity assay. No target required.
See reference/experiments.md for detailed information on each assay and its outputs.
Protein Sequence Optimization
Before submitting sequences, optimize them for better expression and stability:
Common issues to address:
- Unpaired cysteines that create unwanted disulfides
- Excessive hydrophobic regions causing aggregation
- Poor solubility predictions
Recommended tools:
- NetSolP / SoluProt - Initial solubility filtering (both are web services, not pip packages)
- SolubleMPNN - Solubility-biased sequence redesign (a weight set within the ProteinMPNN / LigandMPNN family)
- ESM (
fair-esm) - Sequence likelihood / naturalness scoring - ipTM (AlphaFold-Multimer / ColabFold) - Interface stability for binder designs
- pSAE - Solvent-accessible hydrophobic exposure, from a predicted/known structure
See reference/protein_optimization.md for detailed optimization workflows and tool usage.
API Reference
For complete API documentation including all endpoints, request/response formats, and authentication details, see reference/api_reference.md.
Examples
For concrete code examples covering common use cases (experiment submission, status tracking, result retrieval, batch processing), see reference/examples.md.
Important Notes
- The Foundry API is public but still evolving — treat the OpenAPI doc (
/api/v1/openapi.json) as the source of truth and verify field names before relying on them. - Submission is staged: create a
draft(optionally price it first withPOST /experiments/cost-estimate),POST .../submit, then review andPOST .../quote/confirm. Nothing is invoiced until the quote is confirmed.skip_draft/auto_accept_quoteon create exist for pre-validated automated pipelines — use them only when the user has approved the spend. affinity/screening/epitope_binningrequire atarget_idfrom the catalog (GET /targets) andaffinity/screeningalso amethod(bli|spr);thermostability,fluorescence,expression, andenzyme_activitytake neither.- Authentication is
Authorization: Bearer <token>;GET /whoamiconfirms which organization a token acts for. - Turnaround is multiple weeks — read the estimate from the experiment/quote rather than assuming a fixed number.
- Support and docs: support@adaptyvbio.com /
https://docs.adaptyvbio.com. - Suitable for high-throughput AI-driven protein design workflows (closed-loop design → test → learn).
Part of the AlterLab Academic Skills suite.
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/alterlab-ieu/alterlab-academic-skills/alterlab-adaptyv">View alterlab-adaptyv on skillZs</a>