Repository navigation
Releases
culsmaOS 0.2.0 — Mac desktop and MCP preview
culsmaOS 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.
culsmaOS 0.2.0rc1 — Mac desktop preview
Native macOS Apple Silicon test release with a self-contained Python runtime,
the official Opentrons simulator and an isolated 43-tool MCP bridge.
Download: culsmaOS-0.2.0rc1-macOS-arm64.dmg → drag CulsmaOS Preview.app to Applications.
- macOS 15+ / Apple Silicon; no system Python or Flutter installation needed.
- Experimental, ad-hoc signed and not Apple notarized. First launch may require System Settings → Privacy & Security → Open Anyway.
- Simulation only. No Hamilton software, site layouts or physical instrument access is bundled.
- Start the App, then configure your AI client's stdio command as
/Applications/CulsmaOS Preview.app/Contents/MacOS/culsma-mcp. - User files live in
~/Culsma Preview; uninstalling the App preserves experiment files and records.
Locally accepted: fresh-workspace startup, MCP file create/edit/revision conflict,
installed driver-profile queries, official simulator transfer completion and native
result-display receipt. The app signature is verified again after execution.
No GitHub Actions runs were used. Physical hardware and Windows packaging are not accepted by this release.
The Python wheel/source and exact compatibility wheels are also attached for CLI users.
culsmaOS 0.1.1 — Experimental preview
culsmaOS executes independent Culsma experiment programs through external instrument plugins, coordinates station resources, and records device execution evidence separately from proposed material changes.
This is an experimental preview for one station, one worker, and fixed simulator configurations.
Included
- One-shot execution and a resident FIFO program queue using the same OS components.
- Transfer, supported thermal/agitation operations, magnetic separation, and configured Flex plate movement through external plugins.
- Persistent resource ownership, execution evidence, and conservative recovery: unknown device outcomes retain isolation and are not automatically replayed.
- Runnable Transfer, PCR, and magnetic buffer-exchange examples; updated documentation, shared Culsma branding, and a compact architecture overview.
Installation
Follow the installation instructions and quick start. This release includes the exact compatible language and Opentrons plugin wheels alongside the OS wheel and source archives. No PyPI publication is required.
Validation and scope
The runtime baseline passed 967 tests with 10 optional backend skips in a fresh Python 3.12 environment. A separate fresh Python 3.11 installation passed one-shot Transfer and resident station submission through completion. The final documentation, architecture, acceptance-runner, asset, and packaging checks passed locally.
Primary validation uses the official Opentrons simulator. Physical hardware, GUI, scientific readout, general manual reconciliation, and parallel device execution are outside this preview. Simulator execution does not establish a measured biological result.
License: Apache-2.0. External dependencies retain their own licenses. SHA256SUMS covers all five downloadable package/source artifacts.
culsmaOS 0.1.0 — Experimental source preview
culsmaOS 0.1.0 — Experimental source preview
A laboratory execution host for independent Culsma programs, with one-shot and resident execution, persistent scheduling, station resources, device plugins, execution evidence, material registration and conservative recovery.
Supported restricted simulator profiles include liquid transfer, thermal holds, shaking, magnetic separation and plate motion. Examples cover complete PCR thermal cycling and reduced bead-buffer exchange. Optional centrifuge checks use third-party protocol simulation. This release does not establish real-instrument or scientific-result validation.
Install using the compatible dependency wheels and commands in README.md. PyPI publication is deferred. Tests and package builds run locally; this release has no GitHub Actions workflows.
License: Apache-2.0, matching the independent Culsma language project. DOI registration/automation and PyPI publication are deferred. The repository remains private; this is an experimental prerelease, not a claim of production readiness.
Privacy cleanup (2026-10-18): local filesystem paths were redacted from Git history. Previously uploaded source archives were withdrawn; use GitHub's generated source archives for this tag. The runtime wheel is unchanged. Version 0.1.1 prepares the current public installation profile.
Culsma OS compatibility dependencies (development preview)
Compatibility preview for culsmaOS
Two independent, commit-labelled wheels for the validated development profile:
- Culsma language:
1.0.8+gca7a0984d0b5(sourceca7a0984d0b5b0d47a63c39725d8f70529961687). - External Opentrons simulator plugin:
0.1.0+gec4420b00bdc(sourceec4420b00bdca5e4dfc8fc1edaab21ee5d14f841).
These are development snapshots. They do not replace public Culsma 1.0.8 or publish a stable PyPI release. Each wheel remains an independent distribution; hosting the downloads does not introduce a language dependency on OS or devices.
Use the culsmaOS dependency verifier and constrained installation instructions from the matching source preview. Check SHA256SUMS before installation. Local OS acceptance: 130 checks passed on each of Python 3.11 and 3.12, including complete protocols, resident execution and recovery. Upstream language/plugin regression is recorded in the compatibility evidence.
Scientific hardware acceptance, experimental third-party backends and general scientific readout interpretation are outside this preview.
License notice (2026-10-18): the Culsma Opentrons simulator plugin distributed here is licensed under Apache-2.0; see the attached LICENSE-culsma-opentrons-simulator.txt. The Culsma wheel retains its embedded Apache-2.0 license. Compatibility wheels are unchanged. New plugin builds also embed the license directly.