dralkh/seerai/benchling-integration
Claude Code and agent skill by dralkh/seerai
- community
Checking that the SKILL.md file is still in the repository.
Benchling Python SDK and REST API integration for registry entities, inventory, ELN entries, workflows, Benchling Apps, and Data Warehouse queries. Use when automating lab data with benchling-sdk or the v2 API.
Install
npx vskill@latest install dralkh/seerai/benchling-integrationSKILL.md
The same SKILL.md was published earlier as dralkh/seerai/benchling-integration.
Benchling Integration
Overview
Benchling is a cloud platform for life sciences R&D. Access registry entities (DNA, RNA, proteins), inventory, electronic lab notebooks, and workflows programmatically via the Python SDK and REST API.
Version note: Examples target benchling-sdk 1.25.0 (latest stable on PyPI). Docs: benchling.com/sdk-docs. Platform guide: docs.benchling.com.
When to Use This Skill
This skill should be used when:
- Working with Benchling's Python SDK or REST API
- Managing biological sequences (DNA, RNA, proteins) and registry entities
- Automating inventory operations (samples, containers, locations, transfers)
- Creating or querying electronic lab notebook entries
- Building workflow automations or Benchling Apps
- Syncing data between Benchling and external systems
- Querying the Benchling Data Warehouse for analytics
- Setting up event-driven integrations with AWS EventBridge
Core Capabilities
1. Authentication & Setup
Python SDK installation:
Preview builds (alpha; not for production):
Environment variables (scoped reads only):
Read only the named keys you need — never dump or iterate over the full environment:
Obtain an API key from Profile Settings in Benchling. For OAuth apps, use the Developer Console and store BENCHLING_CLIENT_ID / BENCHLING_CLIENT_SECRET separately.
Authentication methods:
API key (scripts and personal automation):
OAuth client credentials (multi-user apps and production integrations):
Key points:
- All API requests require HTTPS; network calls must target your tenant URL only
- Authentication permissions mirror UI permissions
- Verify credentials with
benchling.users.get_me()before bulk operations
For detailed authentication information including OIDC and security best practices, refer to references/authentication.md.
2. Registry & Entity Management
Registry entities include DNA sequences, RNA sequences, AA sequences, custom entities, and mixtures. The SDK provides typed classes for creating and managing these entities.
Creating DNA Sequences:
Registry Registration:
To register an entity directly upon creation:
Important: Use either entity_registry_id OR naming_strategy, never both.
Updating Entities:
Unspecified fields remain unchanged, allowing partial updates.
Listing and Pagination:
Key Operations:
- Create:
benchling.<entity_type>.create() - Read:
benchling.<entity_type>.get_by_id(id)or.list() - Update:
benchling.<entity_type>.update(id, update_object) - Archive:
benchling.<entity_type>.archive(id)
Entity types: dna_sequences, rna_sequences, aa_sequences, custom_entities, mixtures
For comprehensive SDK reference and advanced patterns, refer to references/sdk_reference.md.
3. Inventory Management
Manage physical samples, containers, boxes, and locations within the Benchling inventory system.
Creating Containers:
Managing Boxes:
Transferring Items:
Key Inventory Operations:
- Create containers, boxes, locations, plates
- Update inventory item properties
- Transfer items between locations
- Check in/out items
- Batch operations for bulk transfers
4. Notebook & Documentation
Interact with electronic lab notebook (ELN) entries, protocols, and templates.
Creating Notebook Entries:
Linking Entities to Entries:
Key Notebook Operations:
- Create and update lab notebook entries
- Manage entry templates
- Link entities and results to entries
- Export entries for documentation
5. Workflows & Automation
Automate laboratory processes using Benchling's workflow system.
Creating Workflow Tasks:
Updating Task Status:
Asynchronous Operations:
Some operations are asynchronous and return tasks. The SDK default max_wait_seconds for polling is 600 seconds (since SDK 1.11.0):
Key Workflow Operations:
- Create and manage workflow tasks
- Update task statuses and assignments
- Execute bulk operations asynchronously
- Monitor task progress
6. Events & Integration
Subscribe to Benchling changes via AWS EventBridge (customer-owned bus) or Webhooks (recommended for new Benchling Apps). EventBridge delivers hydrated v2 API objects; webhooks use thinner payloads.
Common EventBridge `detail-type` values:
v2.dnaSequence.created,v2.dnaSequence.updatedv2.entity.registeredv2.entry.created,v2.entry.updatedv2.workflowTask.updated.statusv2.request.created
Minimal EventBridge rule (filter request creation by schema name):
Lambda handler skeleton:
Setup flow:
- Tenant admin creates a subscription at
https://your-tenant.benchling.com/event-subscriptions - Associate the AWS partner event source with a dedicated event bus immediately (within ~12 days)
- Create rules + targets (Lambda, SQS, SNS) and grant invoke permissions
- Validate with a CloudWatch Logs rule, then trigger a matching Benchling action
Recovery: EventBridge deliveries are not replayed. Use the List Events API for events up to ~2 weeks old after outages.
For payload schema, CloudFormation templates, SDK list/recovery examples, and validation steps, see references/eventbridge.md.
7. Data Warehouse & Analytics
Query historical Benchling data using SQL through the Data Warehouse.
Access Method: The Benchling Data Warehouse provides SQL access to Benchling data for analytics and reporting. Connect using standard SQL clients with provided credentials.
Common Queries:
- Aggregate experimental results
- Analyze inventory trends
- Generate compliance reports
- Export data for external analysis
Integration with Analysis Tools:
- Jupyter notebooks for interactive analysis
- BI tools (Tableau, Looker, PowerBI)
- Custom dashboards
Best Practices
Error Handling
The SDK automatically retries failed requests:
Pagination Efficiency
Use generators for memory-efficient pagination:
Schema Fields Helper
Use the fields() helper for custom schema fields:
Forward Compatibility
This is the start of the file. Read the full SKILL.md on GitHub.
Security
- Security scanPassed, 95 of 100Pattern checks on the skill's files.
- Model reviewPassed
Quality evaluation
- Task evaluationNot runNo evaluation yet. Run one in Skill Studio.
Source
- SKILL.md in the repositoryCheckingskills/benchling-integration/SKILL.md
Popularity
- Repository stars
- 81
- Repository forks
- 5
- 7-day trend score
- 22
Stars and forks are for the whole GitHub repository, not this skill alone. Not refreshed yet.
Works with
Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.
- Claude Code
- Cursor
- GitHub Copilot
- Windsurf
- Codex
- Gemini CLI
- Cline
- Amp
- Roo Code
- Goose
- Continue
- Kilo Code
- Junie
- Trae
- OpenHands
- Qwen Code
- AI Agent
- Tabnine Chat
- Sourcegraph Cody
- Amazon Q
- Firebase Genkit
- Sweep
- Devin
- Phind
- Mentat
- Claude Desktop
- Aider
- GPT Pilot
- Plandex
- bolt.new
- v0
- Replit Agent
- Anse
- TypingMind
- BetterChatGPT
- LibreChat
- Warp AI
- Pieces
- Fig AI
Embed badge
[](https://verified-skill.com/skills/dralkh/seerai/benchling-integration)