benchling-integration

Benchling Integration Skill

Skill Overview

Benchling Integration is a life-sciences research platform integration skill that provides a Python SDK and REST API access to help users automate the management of biological sequences, lab inventory, electronic lab notebooks, and workflows.

Applicable Scenarios

1. Biological Sequence and Registry Management

When you need to create, update, or query DNA, RNA, or protein sequences in bulk via Python code, this skill can help you complete the task quickly. It supports batch importing sequences from FASTA files, automatically registering them in the registry, managing custom entities, and other operations—suitable for research scenarios that need to handle large amounts of biological data.

2. Laboratory Inventory Automation

For labs that need to manage physical inventory such as samples, containers, or box locations, this skill can automate inventory tracking. It includes creating containers, managing storage locations, performing inventory transfers, and batch inventory counts—especially suitable for high-throughput experimental settings.

3. Workflow Automation Integration

If your lab uses the Benchling workflow system, this skill can help you automatically create and update workflow tasks, listen for task status changes, and trigger downstream processes. Combined with AWS EventBridge, it can enable event-driven real-time integration—ideal for scenarios that require connecting Benchling with other systems.

Core Features

1. Biological Sequence Management

Manage DNA, RNA, amino-acid sequences, and custom entities via typed Python SDK classes. Supports creating sequences, updating attributes, paginated list queries, archival operations, and full CRUD functionality. You can set a sequence's circular/linear status, custom fields, registry registration, and other properties.

2. Inventory and Sample Management

Manage lab physical inventory, including creating and tracking containers, boxes, locations, and plates. Supports inventory transfers, check-in/check-out, and bulk operations. You can automatically record custom fields such as concentration and preparation date to fully digitize inventory information.

3. Electronic Lab Notebook and Workflows

Create and query ELN experiment entries and link biological entities and results to experiment records. Manage workflow task creation, status updates, and assignment. Supports asynchronous operations and task progress monitoring—suitable for building end-to-end lab automation pipelines.

Frequently Asked Questions

How do I install and configure the Benchling Python SDK?

Installation is simple: use uv pip install benchling-sdk or poetry add benchling-sdk. For configuration, obtain an API key from Benchling personal settings, then authenticate using ApiKeyAuth or OAuth Client Credentials. All API requests require HTTPS.

How do I bulk import DNA sequences using the Benchling API?

You can use the SDK together with BioPython's SeqIO module. Iterate over each record in a FASTA file and call benchling.dna_sequences.create() to create sequences. The SDK supports a generator-style pagination that is very memory efficient, making it suitable for handling large amounts of sequence data.

How can I automate Benchling inventory transfers?

Use the benchling.containers.transfer() method to move a container to a new location. Bulk transfer operations are supported so you can update the locations of multiple containers at once. Combined with the workflow task system, you can automatically move samples to specified storage locations after an experiment completes.

How should I handle Benchling API call failures?

The SDK includes a built-in automatic retry mechanism that will retry up to 5 times for 429, 502, 503, and 504 status codes using an exponential backoff strategy. You can also customize the RetryStrategy to adjust retry counts and intervals. For asynchronous operations, you can use the wait_for_task helper function to wait for tasks to complete.

What prerequisites are required for this skill?

You need a Benchling account and an API key to use this skill. API keys are obtained from Benchling's Profile Settings. Authentication permissions align with your account permissions in the UI. It is recommended to store API keys in environment variables and not commit them to version control.