opentrons-dev-update

Guide Opentrons monorepo setup and update workflows with dependency troubleshooting.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Helps users set up, update, and diagnose local development environments for the Opentrons monorepo so the codebase builds and runs locally without dependency or PATH-related failures.

Core Features & Use Cases

  • Guided setup and updates: Walk users through cloning the repo and running make setup, make setup-py, and make setup-js to install Python and Node dependencies.
  • Dependency troubleshooting: Diagnose common issues with pyenv, uv, nvs, yarn, Node.js, Python versions, Homebrew, and git, and recommend teardown/setup cycles or PATH fixes.
  • New contributor onboarding: Explain terminal concepts, verification commands, and how to share terminal outputs for iterative debugging.

Quick Start

Ask the assistant: Could you set up the Opentrons development environment?

Frequently Asked Questions about opentrons-dev-update

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

FAQPage Schema
How do I set up the Opentrons development environment from scratch?

To set up the Opentrons development environment, clone the monorepo and run make setup to install Python and Node dependencies. The assistant guides you through cloning, running make setup, make setup-py, and make setup-js to ensure correct versions are installed.

Why does make setup fail with pyenv or nvs errors in the Opentrons repo?

Make setup fails with pyenv or nvs errors due to incorrect Python or Node versions, PATH misconfigurations, or incomplete dependency refreshes. The assistant diagnoses these by running teardown/setup cycles and requesting terminal verification outputs for stepwise debugging.

What's the best way to refresh Python and Node dependencies for the Opentrons monorepo?

The best way to refresh dependencies is running make teardown followed by make setup to clear and reinstall Python and Node packages. This ensures a clean state by resolving conflicts with yarn, uv, pyenv, and nvs version managers.

Do I need Homebrew and git to contribute to the Opentrons codebase locally?

Yes, you need Homebrew and git to contribute to the Opentrons codebase locally. Homebrew installs system-level dependencies while git clones the repository, and the assistant verifies their installation and troubleshoots related errors during setup.

How do I fix PATH-related failures when running make setup-js for Opentrons?

Fix PATH-related failures during make setup-js by ensuring nvs and yarn directories are correctly referenced in your shell configuration. The assistant diagnoses Node.js and nvs errors by requesting terminal verification outputs to identify missing PATH entries.