Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Install MiRMiR

MiRMiR ships as one native binary. Install version 0.6.2 from crates.io:

cargo install mirmir --version 0.6.2 --locked
mirmir --version

The final command should print mirmir 0.6.2.

Platform requirements

MiRMiR currently targets accelerator-backed inference:

  • Apple Silicon macOS uses the Metal backend and requires the native MLX 0.32.4 framework;
  • Linux uses CUDA and requires a supported NVIDIA driver, CUDA Toolkit 13, and git;
  • no Python, PyTorch, or Transformers runtime is used in the request path.

On Linux, the build compiles native CUDA kernels. It uses the toolkit in /usr/local/cuda, or the one named by CUDA_HOME (and NVCC for a specific compiler); nvcc does not need to be on PATH. The first build fetches the pinned CUTLASS and FlashAttention sources into ~/.cache/mircuda; set MIRCUDA_CUTLASS_DIR and MIRCUDA_FLASH_ATTN_DIR to reuse existing checkouts or build offline. Kernels target sm_120f (Blackwell) by default; set MIRCUDA_CUDA_ARCH for another architecture.

For a source build, clone the application repository and build it using its pinned Rust toolchain:

git clone https://github.com/mirmir-tech/mirmir.git
cd mirmir
cargo build --release --locked

Initialize configuration

mirmir config init
mirmir config validate

The persistent files are stored under ~/.config/mirmir. Runtime state and the fallback Unix socket live under ~/.local/state/mirmir.

Open the terminal dashboard

Run MiRMiR without a subcommand:

mirmir

The process attaches to an existing local runtime when one is available. If it starts a temporary runtime itself, it also shuts that runtime down when the TUI exits.

Continue with Run your first model.

Upgrading an existing installation? Read Upgrade to 0.6.2, Upgrade to 0.6.1, Upgrade from 0.3, or Upgrade from 0.2 for older installations.