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.

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/arimxyer/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