Install and update¶

Requirements¶

The published Mac packages require an Apple silicon Mac and macOS 14 or later. GPU availability depends on the model and hardware. Model weights need additional disk space and memory. The Mac download does not install an NVIDIA server build.

Command-line installer¶

curl -fsSL https://nsimaging.ai/spum/install.sh | sh
spum --version
spum --help

The installer verifies the archive checksum and signing identity before installation. It installs into ~/.local/bin by default. For a different directory:

curl -fsSL https://nsimaging.ai/spum/install.sh -o install-spum.sh
SPUM_INSTALL_DIR="$HOME/.local/bin" sh install-spum.sh

You can inspect the downloaded installer before running it. If the shell cannot find spum, add its directory to your shell's PATH:

export PATH="$HOME/.local/bin:$PATH"

Homebrew command-line engine¶

brew install vinayapathak/spum/spum
brew update
brew upgrade vinayapathak/spum/spum

Standalone Mac application¶

brew install --cask vinayapathak/spum/spum-app
open -a Spum

The standalone app has its own native window and menu-bar companion. spum app starts the separate legacy browser interface; it is not the same application.

Check which installation runs¶

command -v spum
type -a spum
spum --version

If both Homebrew and the shell installer are present, the first matching PATH entry wins. Updating one does not update the other. Re-run the shell installer to update its copy. Keep one preferred command-line installation to avoid confusion.

Remove a Homebrew installation¶

brew uninstall vinayapathak/spum/spum
brew uninstall --cask vinayapathak/spum/spum-app

These uninstall commands do not imply that downloaded model files or conversations have been erased. Review your own data separately before deleting it.