opentrons-dev-setup

Configure an Opentrons development environment from source on macOS and Linux.

1|Updated Mar 4, 2026
One-click install
npx skills add https://github.com/koji/opentrons-devenv-skill --skill opentrons-dev-setup
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: opentrons-dev-setup
Source: https://github.com/koji/opentrons-devenv-skill/tree/main/opentrons-dev-setup
Command: npx skills add https://github.com/koji/opentrons-devenv-skill --skill opentrons-dev-setup

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill guides users through setting up a local development environment for the Opentrons monorepo, reducing friction for new contributors and streamlining troubleshooting during dev setup.

Core Features & Use Cases

  • OS-aware setup guidance: Provides macOS and Linux setup paths with tool version requirements and verification steps.
  • Toolchain provisioning: Explains and sequences pyenv, nvs, uv, yarn, Node.js, Python, make, and brew installation and verification.
  • Troubleshooting and verification: Includes a final verification checklist and common issue fixes to minimize setup failures.

Quick Start

Clone the Opentrons repository and run the full setup to install dependencies.

Frequently Asked Questions about opentrons-dev-setup

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I set up a local Opentrons development environment from source?

Yes, this Opentrons dev setup provides OS-aware guidance for both macOS and Linux, including tool version requirements and verification steps tailored to each platform's package management approach.

What tools do I need to install before building the Opentrons monorepo?

Opentrons dev setup includes a final verification checklist and common issue fixes to minimize setup failures. If errors occur during make or dependency installation, the troubleshooting guidance helps diagnose and resolve typical environment configuration problems.

Do I need pyenv and uv to contribute to the Opentrons project?

Yes, pyenv and uv are required tools for Opentrons development alongside nvs, yarn, Node.js, Python, and make. These manage Python versions and package dependencies needed to run the monorepo from source on macOS or Linux.

Why does my Opentrons setup fail after cloning the repository?

Opentrons setup failures typically stem from missing or misconfigured toolchain dependencies like pyenv, nvs, uv, or incorrect Node.js and Python versions. The skill's troubleshooting section addresses common errors and provides a verification checklist to resolve them.