Installation

Installation

Cargo (from crates.io)

Works on any platform with Rust installed.

cargo install modelsdev

Requires Rust (stable). Install via rustup if you don't have it.

Nix (flake)

Run the latest main flake directly from GitHub:

nix run github:reyamira/models

Install it into your profile:

nix profile install github:reyamira/models

To pin a release, include the tag:

nix run github:reyamira/models/v0.11.52
nix profile install github:reyamira/models/v0.11.52

The flake is available from GitHub tags. It is not currently published to FlakeHub or nixpkgs.

Homebrew (macOS/Linux)

brew install models

models is in Homebrew core -- updates land through homebrew-core bump PRs.

Migrating from the tap? Run brew untap arimxyer/tap to remove the old tap. Updates now come through Homebrew core and may take a bit longer to land after a release.

Scoop (Windows)

scoop install extras/models

Scoop Extras handles updates automatically.

Migrating from the custom bucket? Run scoop bucket rm arimxyer to remove the old bucket.

Arch Linux (AUR)

paru -S models-bin   # or: yay -S models-bin

Maintained by @Dominiquini. Updated automatically by the release workflow.

Debian / Ubuntu

Download the .deb from GitHub Releases and install:

# amd64
sudo dpkg -i modelsdev_*_amd64.deb

# arm64
sudo dpkg -i modelsdev_*_arm64.deb

Fedora / RHEL

Download the .rpm from GitHub Releases and install:

# x86_64
sudo rpm -i modelsdev-*.x86_64.rpm

# aarch64
sudo rpm -i modelsdev-*.aarch64.rpm

Pre-built binaries

Download the latest release for your platform from GitHub Releases. Available targets:

Platform	Target
Linux (x86_64)	x86_64-unknown-linux-gnu
Linux (ARM64)	aarch64-unknown-linux-gnu
macOS (Intel)	x86_64-apple-darwin
macOS (Apple Silicon)	aarch64-apple-darwin
Windows (x86_64)	x86_64-pc-windows-msvc

Build from source

git clone https://github.com/reyamira/models
cd models
cargo build --release
./target/release/models

Verifying downloads

Each GitHub Release includes a SHA256SUMS file. After downloading a binary, .deb, or .rpm:

# Download SHA256SUMS from the same release
sha256sum -c SHA256SUMS --ignore-missing

Setting up command aliases

models supports standalone agents, benchmarks, and mstatus commands via symlinks. This lets you type agents status instead of models agents status.

mkdir -p ~/.local/bin
ln -s $(which models) ~/.local/bin/agents
ln -s $(which models) ~/.local/bin/benchmarks
ln -s $(which models) ~/.local/bin/mstatus

You can also use models link to create all three symlinks automatically. Alias names are configurable via the [aliases] section in your config file (see Configuration).

Make sure ~/.local/bin is in your PATH:

• bash/zsh: Add export PATH="$HOME/.local/bin:$PATH" to your shell config
• fish: Run fish_add_path ~/.local/bin

Shell completions

Generate completions for your shell:

models completions bash    # bash
models completions fish    # fish
models completions zsh     # zsh

Follow your shell's instructions for installing completion files. For example, with fish:

models completions fish > ~/.config/fish/completions/models.fish