Install and Start

Install the CulsmaOS 0.2.0 Mac simulator preview and open a local workstation. The installation includes Python, Culsma 1.0.10, the official Opentrons simulator, the native desktop and an isolated MCP bridge.

Requirements

• Apple Silicon Mac with macOS 15 or later.
• The 0.2.0 release DMG. No separate Python, Flutter or developer tools are needed for the App.

The default package runs simulations. Hamilton requires a separately installed compatible driver and workstation configuration. Windows packaging is not included. See Versions and Supported Features.

Install the App

1. Download culsmaOS-0.2.0-macOS-arm64.dmg.
2. Open the DMG and drag CulsmaOS Preview.app into Applications. Eject the disk image.
3. Open CulsmaOS Preview. This preview is ad-hoc signed and not Apple notarized. If macOS blocks it, review System Settings → Privacy & Security → Open Anyway.
4. Wait for the workstation to become ready. Open Files → Experiments → Transfer → transfer.culs for the first simulation.

The release includes SHA256SUMS for download verification. The final DMG was tested after copying the App to a new location and using an isolated user Home.

Your files and settings

Content	Default location
Experiment files	~/Culsma Preview/projects
Result-file workspace	~/Culsma Preview/results
Station configuration and logs	~/Library/Application Support/culsmaOS/preview
Generated MCP client snippet	~/Library/Application Support/culsmaOS/preview/mcp-config.json

Subsequent starts preserve existing files and workstation configuration. A result-file workspace is not a promise that every run exports a file there; run records also live in station storage.

Confirm startup and stop safely

Open System Info or ask your connected agent to read workstation status. The bundled status command is:

"/Applications/CulsmaOS Preview.app/Contents/MacOS/culsma-status"

Wait for ready before starting an experiment. Closing the desktop window leaves the local resident available to MCP. Inspect active runs before stopping it:

"/Applications/CulsmaOS Preview.app/Contents/MacOS/culsma-stop"

Close the UI and stop the resident before replacing or removing the App. Removing the App preserves experiments and run records.

Python and development installations

The separate OS wheel supports Python 3.11 and 3.12. Follow the 0.2.0 CLI installation instructions with the matching dependency files. Installing a wheel alone does not install the Mac desktop bundle. OS PyPI publication remains deferred.

Developers building the native console can use the tagged development instructions. Keep simulator and MCP dependencies in separate environments.

Next: Connect Your AI Agent, or Your First Simulation.