Getting Started

Installation

Install Stratum on Windows, macOS, or Linux, or build from source.

Prebuilt installers are published on GitHub Releases for Windows, macOS and Linux. You can also build Stratum from source.

Requirements

Component	Required?	Notes
Git	Yes	Stratum shells out to the git CLI for all versioning.
Ollama	No	Enables local AI tagging + semantic search; keyword search works without it.
Node.js 20.19+	Build only	Only needed if you build from source.
Rust (stable)	Build only	Only needed if you build from source.

Download

Grab the latest installer from the Stratum Releases page. Pick the file that matches your operating system:

Platform	Files
Windows	.exe (NSIS installer) or .msi
macOS	.dmg or .app.tar.gz
Linux	.AppImage, .deb or .rpm

Windows

Download Stratum_x.y.z_x64-setup.exe (or the .msi).
Run the installer and follow the prompts.
Launch Stratum from the Start menu.

If SmartScreen warns about an unknown publisher, choose More info → Run anyway. Stratum is unsigned by default; checksums and a software bill of materials are attached to each release.

macOS

Download the .dmg for your chip (Apple silicon or Intel).
Open the disk image and drag Stratum into Applications.
The first launch may be blocked by Gatekeeper. Right-click the app and choose Open, then confirm.

Linux

shell

chmod +x Stratum_x.y.z_amd64.AppImage
./Stratum_x.y.z_amd64.AppImage

Build from source

Requirements: Node.js 20.19+, Rust stable, and the Tauri system prerequisites for your platform.

shellshell

git clone https://github.com/AkkilMG/Stratum.git
cd Stratum
npm install

npm run tauri dev      # run in development
npm run tauri build    # produce installers in src-tauri/target

See Building from source for per-platform details and how to contribute.

Optional Ollama models

To enable AI tagging and semantic search, install Ollama and pull the two models. You can also do this from inside Stratum (Settings → Local AI).

shell

ollama pull llava:7b
ollama pull nomic-embed-text

Verify the install

Launch Stratum and continue to First launch. The setup wizard's system-check step confirms that Git (and optionally Ollama) are detected correctly.