Install

Fastest path

Use the install script hosted from the official downloads domain:

curl -fsSL https://downloads.maabarium.com/install.sh | sh

That path is best when you want the current released build quickly.

The current hosted desktop release supports Apple Silicon Macs running macOS 11 or later.

What the install script does

On macOS, the published install.sh is generated from release metadata. It reads the root latest.json stable alias, selects the correct signed app bundle for your architecture, downloads it from the official release origin, and installs the app into /Applications.

If Git is missing, Maabarium now detects that during the install or first-run path and attempts to install it automatically through a supported system installer when possible.

Download releases directly

Release artefacts are published from the main repository releases page:

• Latest release
• Install script: https://downloads.maabarium.com/install.sh

Build from source

If you want full control over the workspace, build from source:

git clone https://github.com/maabarium/core.git
cd core/maabarium
cargo build --workspace --locked
cd crates/maabarium-desktop
pnpm install --frozen-lockfile
pnpm build

For an optimised local build that stays portable across machines with the same target family:

cargo build --profile release-lto

For host-specific benchmarking or personal local builds only:

RUSTFLAGS="-C target-cpu=native" cargo build --profile release-lto

Distributed artefacts should keep the portable release-lto profile rather than the native-tuned variant.

What gets installed

A standard desktop install gives you:

• the desktop application
• the embedded runtime logic from maabarium-core
• bundled blueprint resources used by the desktop shell

The CLI may also be bundled as a desktop resource depending on the release packaging flow.

On supported desktop builds, first launch can expose that bundled CLI through a managed shell link at ~/.local/bin/maabarium. The setup flow can install or remove that link for you and warns when ~/.local/bin is not on your shell PATH yet.

Recommended prerequisites

• Git is still required for Git-backed experiment worktrees, but Maabarium now detects when it is missing and can install it automatically through a supported system installer on many machines.
• A workspace folder where Maabarium can create and manage Git-backed experiment worktrees
• Local model tooling or provider credentials, depending on how you plan to run experiments. If you use Ollama locally, the desktop setup flow can install it, start it, and then let you pull the recommended local models from inside the app.

Next step

Continue to Run your first workflow to validate that your installation is actually usable, not just present.