Installation

Use Python 3.11 or 3.12 and a local shell. The resident host uses a Unix-domain socket. Current installed-package validation was performed on macOS; the cancelled Linux full-suite run is not Linux acceptance evidence. Windows operation is not established.

Install from the GitHub release artifacts. The commands below select the compatible language and simulator snapshots automatically; PyPI publication is deferred.

Download the Source Snapshot

The checkout supplies example protocols, deck files and the dependency verifier.

git clone https://github.com/culsma/culsmaOS.git
cd culsmaOS
git checkout 0.1.1
python3.11 -m venv .venv
. .venv/bin/activate

Use python3.12 in place of python3.11 when appropriate. All OS commands in this manual run from the culsmaOS source directory, not the separate documentation directory.

Install the Release Wheels

python -m pip install --constraint requirements/preview-constraints.txt \
  --requirement requirements/preview-downloads.txt \
  'culsma-os[simulator] @ https://github.com/culsma/culsmaOS/releases/download/0.1.1/culsma_os-0.1.1-py3-none-any.whl'
python -m pip check
culsma-os --help

The dependency download list pins wheel URLs and SHA-256 hashes. The release also includes SHA256SUMS for all attached installation artifacts. Exact language and plugin source revisions are in the OS dependency contract.

The simulator is an external package. It uses the official Opentrons simulator; the installation does not require a physical robot or a sibling driver checkout. Continue with First Transfer.