Install

Run mere.run on your own hardware

Pick an install path below, or copy one prompt into your coding agent and let it select the release asset, install, and verify for you.


Install paths

One runtime for multiple hosts

On Apple Silicon, install the macOS app and CLI. On Linux x86_64, install a release package. On Linux arm64 CUDA, build from source.

macOS Apple Silicon

The signed DMG includes the SwiftUI Studio, CLI, optional Codex skill, and Metal runtime.

  • Full app and CLI on Apple Silicon.
  • Signed, notarized, versioned DMG.
  • Includes the full Studio and CLI workflow.

Linux x86_64 CLI

Portable tarball and Debian package for headless x86_64 systems.

  • Tarball, .deb, runtime libraries, and checksums verified at release.
  • CPU CI baseline; CUDA validated separately.
  • x86 CUDA host testing covers GPUs up to 16 GB VRAM.
Use this package for Linux servers and workstations.

Linux arm64 CUDA source

Supported source-build target for DGX Spark-class Blackwell CUDA hosts with 128 GB unified memory. The attached release lane is paused.

  • Builds the headless CLI from the public repository.
  • Requires an arm64 CUDA host and the documented toolchain.
  • No arm64 runtime artifact is attached to v0.43.0.
Build this target from source. v0.43.0 has no attached arm64 runtime package.
Agent-assisted install

Choose a host and copy the prompt

Copy one prompt into your coding agent. It selects the matching release asset, installs in your home directory, and verifies the CLI. A hardware mismatch stops the install.

  • macOS uses the signed DMG and can install the optional use-mere-run skill.
  • Linux x86_64/amd64 uses the portable CLI tarball from GitHub Releases.
  • Linux arm64/aarch64 uses the source-build path while its attached CUDA release lane is paused.
agent-install-macos.txt
You are helping me install mere.run locally on this Mac.

Rules:
- Do not use sudo.
- Do not edit shell profiles unless I ask.
- Prefer user-local install paths.
- Read release metadata from https://mere.run/.well-known/mere-run/release.json.
- Stop and explain if the macOS DMG URL is missing or the DMG mount fails.

Steps:
1. Resolve the macOS DMG URL:
   release_json="$(curl -fsSL "https://mere.run/.well-known/mere-run/release.json")"
   dmg_url="$(printf '%s' "$release_json" | python3 -c 'import json,sys; data=json.load(sys.stdin); print((data.get("downloads") or {}).get("macos_dmg") or data.get("download_url") or "")')"
   test -n "$dmg_url" || { echo "No macOS DMG URL found in release metadata."; exit 1; }
2. Download the DMG to a temporary folder:
   work_dir="$(mktemp -d)"
   dmg_path="$work_dir/mere-run.dmg"
   curl -fL "$dmg_url" -o "$dmg_path"
3. Mount the DMG, or reuse it if it is already mounted:
   hdiutil attach -nobrowse -readonly "$dmg_path"
   volume=""
   for candidate in "/Volumes/mere.run" /Volumes/mere.run* /Volumes/MereRun* "/Volumes/Mere Run"*; do
     if [ -d "$candidate" ] && [ -x "$candidate/.mere-run/install.sh" ]; then
       volume="$candidate"
       break
     fi
   done
   if [ -z "$volume" ]; then
     echo "Mounted the DMG, but could not find the mere.run volume."
     hdiutil info
     exit 1
   fi
4. Verify the mounted volume contains MereRun.app plus .mere-run/install.sh:
   test -d "$volume/MereRun.app"
   test -x "$volume/.mere-run/install.sh"
5. If /Applications/MereRun.app is missing, copy the app there:
   if [ ! -d "/Applications/MereRun.app" ]; then
     ditto "$volume/MereRun.app" "/Applications/MereRun.app"
   else
     echo "/Applications/MereRun.app already exists. Leaving it in place."
   fi
   If the copy is denied, tell me to drag MereRun.app to Applications, then continue with CLI and skill setup.
6. Install the CLI to ~/.local/bin/mere.run:
   mkdir -p "$HOME/.local/bin"
   MERERUN_INSTALL_BIN_DEST="$HOME/.local/bin/mere.run" "$volume/.mere-run/install.sh"
7. Install the bundled use-mere-run Codex skill if it exists:
   skill_source=""
   for candidate in "$volume/MereRun.app/Contents/Resources/skills/use-mere-run" "$volume/.mere-run/skills/use-mere-run"; do
     if [ -d "$candidate" ]; then
       skill_source="$candidate"
       break
     fi
   done
   if [ -n "$skill_source" ]; then
     mkdir -p "$HOME/.codex/skills"
     rm -rf "$HOME/.codex/skills/use-mere-run"
     ditto "$skill_source" "$HOME/.codex/skills/use-mere-run"
   fi
8. Verify the CLI:
   "$HOME/.local/bin/mere.run" --help
   "$HOME/.local/bin/mere.run" model capabilities --recommended
9. Pull the starter image model:
   "$HOME/.local/bin/mere.run" model pull image-zimage-nano
10. Generate and open the first image:
   "$HOME/.local/bin/mere.run" image generate --model image-zimage-nano --prompt "a ceramic mug in soft morning light on a walnut desk" --width 1024 --height 1024 --steps 8 --seed 2026 --output "$HOME/Desktop/mere-first-image.png"
   open "$HOME/Desktop/mere-first-image.png"

At the end, tell me where the app, CLI, skill, model store, downloaded DMG, mounted volume, and image are.
Mere apps

Apps declare what they need

The public Mere CLI finds or installs mere.run, then pulls the models an app declares. It can use an existing binary, build from source, or install a verified release.

  • mere setup mere-run prepares the runtime.
  • mere setup mere-run models --app media pulls Media's ASR and embedding models.
  • Inference stays on the user's machine.
mere apps · setup
$ npm install -g @merekit/cli installs the Mere CLI
$ mere setup mere-run --json runtime ready · existing binary, source build, or verified release artifact
$ mere setup mere-run models --app media --json speech-asr-parakeet · text-embed-qwen3-0.6b
$ mere media process ./interview.m4a --transcribe --embed transcript + searchable segments generated locally
macOS Studio

The CLI
with controls

Studio uses the same runtime and model store as the CLI. Check whether a model fits, start a run, watch its progress, and find the outputs on disk.

  • Fit and download size before pulling
  • Load, pin, time-to-live, and runtime controls
  • Generation progress and run history
  • Included in the signed macOS DMG
  • iOS Studio source supports hosted Relay or direct Mac pairing

The screenshot shows an earlier macOS Studio build. Studio reads model availability from the same catalog and model store as the CLI.

An earlier MereRun Studio build on macOS: the Models sheet listing installed models with sizes and readiness, runtime settings with TTL and pinning, and the create sidebar navigation.