Install
Stemma has a desktop app and a command, stemma. The app needs the command installed: it uses it to run your computer's background service. Each release publishes both, for macOS on Apple silicon and for Linux on x86_64.
Use the same version on your computer as the hub runs. When the hub is updated, update your computer too. Otherwise it cannot connect, and says so.
macOS (Apple silicon)
With Homebrew, one command installs both:
brew install --cask stemma-math/tap/stemma-appTo update later:
brew upgrade stemma stemma-appTo install without Homebrew, take two files from the latest release:
stemma-app-<version>-aarch64-apple-darwin.dmg. Open it and drag Stemma to Applications.stemma-<version>-aarch64-apple-darwin.tar.gz. Unpack it and putstemmasomewhere on yourPATH, such as/usr/local/binor~/.local/bin.
The app is not signed by a developer
macOS refuses to open a downloaded app that Apple has not notarized. The Homebrew cask handles this for you. If you installed from the disk image, open it once with right-click › Open, or allow it in System Settings › Privacy & Security. You can also clear its quarantine:
xattr -dr com.apple.quarantine /Applications/Stemma.appIntel Macs have no build yet. Build from source, as described below.
Linux (x86_64)
With Homebrew on Linux:
brew install stemma-math/tap/stemmaOr take stemma-<version>-x86_64-unknown-linux-gnu.tar.gz from the latest release and put stemma on your PATH. It runs on any Linux with glibc as new as Ubuntu 22.04's.
For the app, the release has two packages. Choose one:
stemma-app-<version>-x86_64-unknown-linux-gnu.deb, for Debian and Ubuntu:shsudo apt install ./stemma-app-<version>-x86_64-unknown-linux-gnu.debstemma-app-<version>-x86_64-unknown-linux-gnu.AppImage, for any distribution: make it executable and run it.
The app needs WebKitGTK 4.1, which current desktop distributions include.
Windows
There is no Windows build yet. The command line builds from source and runs in the foreground, with stemma machine run. The background service installs only on macOS and Linux.
From source
You need Rust, Node.js 22 or newer, and pnpm. From a clone of the repository:
just setup # the web app's dependencies
just release # target/release/stemma, with the web app insideTo build the app, run pnpm --dir desktop tauri build. On Linux, install Tauri's prerequisites first.
Check
stemma --version
stemma doctorstemma doctor checks everything Stemma needs on your computer, and says how to fix what is missing. The app shows the same checks in This machine › Overview.