# Adaptyv Protein Experiments

Designs protein assay experiments and submits sequences to the Adaptyv Bio Foundry API.

- Repository: https://github.com/K-Dense-AI/scientific-agent-skills (55651 stars)
- Category: Data and ML
- License: MIT
- Last updated: 2026-10-26
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add K-Dense-AI/scientific-agent-skills --skill adaptyv -g -a claude-code -y`
Codex: `npx skills add K-Dense-AI/scientific-agent-skills --skill adaptyv -g -a codex -y`
Cursor: `npx skills add K-Dense-AI/scientific-agent-skills --skill adaptyv -g -a cursor -y`
Gemini CLI: `npx skills add K-Dense-AI/scientific-agent-skills --skill adaptyv -g -a gemini-cli -y`

## Description

Uses the Adaptyv Bio Foundry API and Python SDK to design protein characterization experiments, estimate costs, submit sequences, monitor laboratory progress, and retrieve results. Applies to Adaptyv Foundry, its target catalog, binding screening and affinity assays, thermostability, expression, fluorescence, epitope binning, and enzyme activity workflows, including code using adaptyv or FoundryClient.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Adaptyv Bio Foundry API

Use this skill to turn protein sequences into experimentally measured data through
Adaptyv's cloud laboratory. Confirm the target construct, assay conditions, controls,
and replicate plan before submitting a batch; turnaround depends on the experiment.

Reviewed against the deployed [OpenAPI schema](https://devs.adaptyvbio.com/api/v1/openapi.json)
(`info.version: 0.0.2`) and official SDK `0.1.0` at commit
`cdf207819ed5a58e0c127453626d2bce125c8064`. The schema version alone does not identify
all changes. See the [endpoint reference](references/api-endpoints.md) for current
request/response details and discrepancies in upstream examples.

## Connect

**Base URL:** `https://devs.adaptyvbio.com/api/v1`. The schema is at
`/openapi.json`; never append that filename to normal endpoint requests.

Create a bearer token in [Foundry](https://foundry.adaptyvbio.com/) under
Organization → Settings → Tokens. Use Viewer for reads and Member for experiment
writes. Read credentials from `ADAPTYV_API_KEY`; the documentation's
`FOUNDRY_API_TOKEN` is an alternative variable name for the same token. If using a
project `.env`, explicitly call `python-dotenv.load_dotenv()` before SDK setup;
the SDK does not load that file automatically. Never print or commit tokens.

```bash
# ADAPTYV_API_KEY is already set in the environment.
curl --fail-with-body 'https://devs.adaptyvbio.com/api/v1/targets?limit=3' \
  -H "Authorization: Bearer $ADAPTYV_API_KEY"
```

Resource endpoints require bearer authentication. The schema and liveness endpoint
`GET /info/health` are public. `GET /whoami` reports the active organization and
permissions; check it when account scope is unclear.

## Python SDK

Install the reviewed revision in your project environment (requires Python 3.11+):

```bash
uv pip install "git+https://github.com/adaptyvbio/adaptyv-sdk.git@cdf207819ed5a58e0c127453626d2bce125c8064"
```

The rest: https://github.com/K-Dense-AI/scientific-agent-skills/blob/HEAD/skills/adaptyv/SKILL.md