🚧Documentation is under active development — content may be incomplete or change frequently.
Skip to Content
Getting Started

Getting Started

Get Salpa running on your machine in a few minutes.

System requirements

PlatformMinimumRecommended
macOSmacOS 12+ (Intel or Apple Silicon)macOS 13+ with Apple Silicon
LinuxUbuntu 20.04+ / Fedora 36+ (x86_64)Ubuntu 22.04+
WindowsWindows 10+ (x86_64)Windows 11

Disk space: ~500 MB for the app, plus additional space for node environments (varies by node).

No prerequisites required — Salpa bundles its own Python environment and all background services. You don’t need to install Python, pip, conda, or any other tooling.

Download and install

All Salpa builds are published on the Salpa Pre-Release page . Pick the latest tag and grab the file that matches your platform:

PlatformFile patternNotes
macOS — Apple Silicon (M1/M2/M3/M4)Salpa-<version>-arm64.dmg
macOS — IntelSalpa-<version>-x64.dmg
Linux — AppImageSalpa-<version>.AppImageRun anywhere; chmod +x first
Linux — Debian/Ubuntusalpa_<version>_amd64.debsudo dpkg -i …
WindowsSalpa-Setup-<version>.exeNSIS installer

macOS

  1. Open the DMG you downloaded and drag Salpa to your Applications folder.
  2. On first launch, macOS may show a security prompt — right-click the app and select “Open”.

Linux (AppImage)

chmod +x Salpa-*.AppImage ./Salpa-*.AppImage

Linux (Debian/Ubuntu)

sudo dpkg -i salpa_*_amd64.deb

Windows

Run the .exe installer and follow the prompts. Launch Salpa from the Start Menu when it finishes.

First launch

When you open Salpa for the first time:

  1. The app will set up its Python environment automatically (this takes 1-2 minutes on first run)
  2. You’ll see the Home page with tips, recent workflows, and quick actions
  3. The status bar at the bottom shows when Salpa is ready to use

Your first workflow

  1. Click New Workflow or use Cmd+N / Ctrl+N
  2. Give your workflow a name (e.g., “My First Workflow”)
  3. Open the Node Library (left sidebar) and browse available nodes
  4. Drag a node (e.g., “Hello World”) onto the canvas
  5. Click the node to open its configuration panel on the right
  6. Click Execute (play button) to run the node
  7. Watch the progress in real-time — logs stream live to the execution panel

Key shortcuts

ActionmacOSLinux/Windows
New workflowCmd+NCtrl+N
Save workflowCmd+SCtrl+S
Command PaletteCmd+KCtrl+K
Toggle themeIn SettingsIn Settings

Next steps