Getting Started
Get Salpa running on your machine in a few minutes.
System requirements
| Platform | Minimum | Recommended |
|---|---|---|
| macOS | macOS 12+ (Intel or Apple Silicon) | macOS 13+ with Apple Silicon |
| Linux | Ubuntu 20.04+ / Fedora 36+ (x86_64) | Ubuntu 22.04+ |
| Windows | Windows 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:
| Platform | File pattern | Notes |
|---|---|---|
| macOS — Apple Silicon (M1/M2/M3/M4) | Salpa-<version>-arm64.dmg | |
| macOS — Intel | Salpa-<version>-x64.dmg | |
| Linux — AppImage | Salpa-<version>.AppImage | Run anywhere; chmod +x first |
| Linux — Debian/Ubuntu | salpa_<version>_amd64.deb | sudo dpkg -i … |
| Windows | Salpa-Setup-<version>.exe | NSIS installer |
macOS
- Open the DMG you downloaded and drag Salpa to your Applications folder.
- On first launch, macOS may show a security prompt — right-click the app and select “Open”.
Linux (AppImage)
chmod +x Salpa-*.AppImage
./Salpa-*.AppImageLinux (Debian/Ubuntu)
sudo dpkg -i salpa_*_amd64.debWindows
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:
- The app will set up its Python environment automatically (this takes 1-2 minutes on first run)
- You’ll see the Home page with tips, recent workflows, and quick actions
- The status bar at the bottom shows when Salpa is ready to use
Your first workflow
- Click New Workflow or use
Cmd+N/Ctrl+N - Give your workflow a name (e.g., “My First Workflow”)
- Open the Node Library (left sidebar) and browse available nodes
- Drag a node (e.g., “Hello World”) onto the canvas
- Click the node to open its configuration panel on the right
- Click Execute (play button) to run the node
- Watch the progress in real-time — logs stream live to the execution panel
Key shortcuts
| Action | macOS | Linux/Windows |
|---|---|---|
| New workflow | Cmd+N | Ctrl+N |
| Save workflow | Cmd+S | Ctrl+S |
| Command Palette | Cmd+K | Ctrl+K |
| Toggle theme | In Settings | In Settings |
Next steps
- Features — Explore all capabilities
- Node System — Understand how nodes and workflows work
- Build Custom Nodes — Create your own computational nodes