adaptyv
How to use the Adaptyv Bio Foundry API and Python SDK for protein experiment design, submission, and results retrieval. Use this skill whenever the user mentions Adaptyv, Foundry API, protein binding assays, protein screening experiments, BLI/SPR assays, thermostability assays, or wants to submit protein sequences for experimental characterization. Also trigger when code imports `adaptyv`, `adaptyv_sdk`, or `FoundryClient`, or references `foundry-api-public.adaptyvbio.com`.
Author
Category
Development ToolsInstall
Download and extract to your skills directory
Copy command and send to AI Agent for auto-install:
Adaptyv Bio Foundry API - Protein Experiment Cloud Platform Integration Skill
Skill Overview
The Adaptyv skill provides a complete API integration solution for the protein experiment cloud platform, helping developers submit amino acid sequences to automated laboratories through the Python SDK or REST API. It supports binding assays, thermostability testing, expression analysis, and fluorescence experiments, with experimental results available in approximately 21 days.
Applicable Scenarios
Drug discovery teams that need to screen the binding capabilities of protein variants at high throughput can submit sequences in batches through the API, use BLI or SPR methods to measure binding affinity, and automatically obtain screening results.
When protein engineers design variants to improve thermostability or optimize expression, they can quickly validate their designs through the cloud laboratory without waiting for the longer timelines of offline experiments.
Research teams can integrate protein design algorithms with experimental validation to automate the entire process from computational prediction to experimental data, creating a closed design-build-test-learn loop.
Core Features
The platform supports five experiment types: affinity measurement (
affinity), binding screening (screening), thermostability analysis (thermostability), expression quantification (expression), and fluorescence intensity measurement (fluorescence). Both BLI and SPR methods are available to meet different research needs.It provides two development modes: the
@lab.experiment decorator and the FoundryClient client. These support integration scenarios ranging from simple scripts to complex pipelines. API keys are read automatically from environment variables, following security best practices.The API supports the entire workflow, from draft creation, cost estimation, and quote confirmation to material preparation, experiment execution, data analysis, and result retrieval. Status changes can be monitored in real time through webhooks, and pipelines can be configured to accept quotes automatically.
Frequently Asked Questions
What is the Adaptyv Bio Foundry API, and how is it used?
The Adaptyv Bio Foundry API is a service interface for a cloud laboratory. Developers can submit protein sequences through the Python SDK or REST API, after which automated laboratories perform the experiments and return the results. Before use, obtain an API key from foundry.adaptyvbio.com, install adaptyv-sdk, and then call the service through FoundryClient or the decorator-based interface.
How do I obtain an Adaptyv API key?
Visit foundry.adaptyvbio.com and register an account. You can then generate a Bearer Token in the sidebar. It is recommended to store the key in the ADAPTYV_API_KEY environment variable or in the project's .env file. The SDK will read it automatically, avoiding hard-coding it in your code.
How long does it take to obtain protein experiment results?
It typically takes approximately 21 days from sequence submission to receipt of complete results, including gene synthesis, material preparation, experiment execution, data analysis, and quality validation. The experiment status is updated in real time through the API and webhooks, allowing you to track the complete workflow from Draft to Done.
What types of protein experiments are supported?
The platform supports five experiment types: affinity measurement, which measures kinetic parameters such as KD, kon, and koff; binding screening, which determines whether binding occurs; thermostability measurement, which determines the melting temperature Tm; expression analysis, which measures expression yield; and fluorescence intensity detection. Affinity and screening experiments require a target protein, while the other three can accept sequences directly.
How can I use webhooks to monitor experiment status?
Pass the webhook_url parameter when creating an experiment. Adaptyv will send a POST request to that URL whenever the status changes, including the experiment ID, previous status, and new status. This is suitable for integrating status notifications into automated pipelines, enabling real-time responses to experiment progress without periodic polling.
What is the difference between BLI and SPR assays?
BLI (biolayer interferometry) and SPR (surface plasmon resonance) are both methods for measuring molecular binding interactions. Both can be used for affinity measurements and binding screens. The choice depends on the specific experimental requirements and the characteristics of the target protein. The API allows you to specify method as "bli" or "spr" in the experiment specification.
How can I retrieve experimental results through the API?
After the experiment status changes to Done, use the client.experiments.get_results(experiment_id) method to retrieve the result data. The results include raw experimental measurements, analytical conclusions, and quality metrics. The result status field is displayed as none, partial, or all; intermediate data can also be retrieved when the experiment is partially complete.