Repository navigation
culsmaOS 0.2.0 — Mac desktop and MCP preview
Pre-releaseculsmaOS 0.2.0 adds a native Mac console and a shared MCP workflow for checking, loading, simulating and reviewing laboratory programs. This preview now uses the published Culsma 1.0.10 language package.
What changed
- Discover instrument capabilities through the shared Device Manager contract, with separate diagnostics for missing drivers, device instances and unsupported operations.
- Check proposed loading with the same preparation policies used during execution. Preserve reviewed layouts and operator confirmation boundaries.
- Support scoped separation and supernatant removal while retaining the sediment in its original container.
- Improve loading review, run results, settings editing and Mac deck-label rendering.
- Provide 51 MCP tools through an isolated, bundled bridge. Keep workflow simulation and device simulation evidence distinct.
Install
Download culsmaOS-0.2.0-macOS-arm64.dmg, open it, and drag CulsmaOS Preview.app to Applications. The package includes Python, the official Opentrons simulator and MCP dependencies. It requires Apple Silicon and macOS 15 or later.
The app is ad-hoc signed and is not Apple notarized. See the installation and MCP guide for first launch. Python users can follow the CLI installation instructions; Python 3.11 and 3.12 are supported. OS PyPI publication remains deferred.
Scope
This is a simulator preview. The default package contains the Opentrons adapter; Hamilton is a separately installed driver. The previously adapted whole-blood branch was exercised in accelerated remote VENUS simulation, which does not establish physical execution or scientific acceptance. Windows packaging is not included.
The attached Culsma 1.0.10 wheel is unchanged from the upstream release. Dependency versions and hashes are recorded in the distribution manifest. SHA256SUMS covers the downloadable distribution assets.
Validation
- Clean installed simulator regression: 1,763 passed, 103 skipped, no failures across all 1,866 collected cases. Skips require optional Hamilton, PyLabRobot, browser or isolated MCP test environments; one further optional Hamilton fault module was unavailable during collection.
- Python 3.12 installed CLI, language handoff, separation/fractionation and execution-chain checks: 35 passed.
- Separate optional Hamilton integration: 41 passed, 1 browser check skipped. These checks use static configuration and labelled device doubles, not physical hardware.
- The final DMG was mounted, copied to a new location and run under an isolated user Home. Bundled MCP editing/conflict handling, official simulator completion, native result display and signature verification passed.
- Wheel/sdist structure, matching runtime files, dependency hashes and Python metadata checks passed. Native UI was rebuilt from an unchanged, clean frontend snapshot.