SAPL Logo
SAPL

Installation

Download and install SAPL on your system

Download SAPL

Choose the download method for your operating system. SAPL includes the interpreter, standard library, and development tools.

Windows
Windows 10/11 (64-bit)
Installer Available
Latest: v0.1.4

Size: ~6.23 MB

Download win installerDownload sapl-win.exeView Release Notes
macOS
macOS 11+ (Intel & Apple Silicon)
GitHub Releases
Latest: v0.1.4

Size: ~5.14 MB

Download sapl-macosView All Releases
Linux
Ubuntu, Debian, CentOS, Fedora
GitHub Releases
Latest: v0.1.4

Size: ~12.4 MB

Download sapl-linuxView All Releases

GitHub Releases

All SAPL releases are available on GitHub. You can find the latest versions, release notes, and source code at:

Visit GitHub Releases

Installation Steps

Windows Installation (Installer)
  1. Download sapl-windows.exe from GitHub releases
  2. Right-click the installer and select "Run as administrator"
  3. Follow the installation wizard steps
  4. The installer will automatically add SAPL to your system PATH
  5. Verify installation by opening Command Prompt and typing sapl --version
macOS Installation (Manual Setup)
  1. Download sapl-macos from GitHub releases
  2. Open Terminal and navigate to your Downloads folder:
cd ~/Downloads
bash
  1. Rename the downloaded file to sapl:
mv sapl-macos sapl
bash
  1. Make the file executable:
chmod +x sapl
bash
  1. Move it to a directory in your PATH (e.g., /usr/local/bin):
sudo mv sapl /usr/local/bin/
bash
  1. Verify the installation:
sapl --version
bash

Note: You may need to allow the app in System Preferences → Security & Privacy → General if macOS blocks the unsigned executable.

Linux Installation (Manual Setup)
  1. Download sapl-linux from GitHub releases
  2. Open terminal and navigate to your Downloads folder:
cd ~/Downloads
bash
  1. Rename the downloaded file to sapl:
mv sapl-linux sapl
bash
  1. Make the file executable:
chmod +x sapl
bash
  1. Move it to a directory in your PATH (e.g., /usr/local/bin):
sudo mv sapl /usr/local/bin/
bash
  1. Verify the installation:
sapl --version
bash

Alternative PATH Setup

If you prefer not to move the executable to /usr/local/bin, you can add its location to your PATH:

macOS/Linux - Custom Directory
  1. Create a directory for SAPL (optional):
mkdir -p ~/bin
bash
  1. Move the SAPL executable there:
mv ~/Downloads/sapl ~/bin/
bash
  1. Add to your PATH by editing your shell profile:
# For bash users
echo 'export PATH="$HOME/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

# For zsh users (macOS default)
echo 'export PATH="$HOME/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc
bash
Windows - Manual PATH Setup

If the installer doesn't add SAPL to PATH automatically:

  1. Right-click "This PC" or "Computer" and select "Properties"
  2. Click "Advanced system settings"
  3. Click "Environment Variables"
  4. Under "System Variables", find and select "Path", then click "Edit"
  5. Click "New" and add the directory containing sapl.exe
  6. Click "OK" to close all dialogs
  7. Restart Command Prompt and test with sapl --version

Verify Installation

After installation, verify that SAPL is working correctly:

Check Version

sapl --version
bash

Expected output: SAPL 0.1.4

Run Hello World

# የሙከራ ፋይል ፍጠር
'አሳይ("ሰላም ዓለም!")' > ሙከራ.ሳፕል

# ፋይሉን አስኪድ
ሳፕል ሙከራ.ሳፕል
bash

Expected output: ሰላም ዓለም!

Interactive Mode (REPL)

sapl
bash

This should open the SAPL interactive interpreter where you can type SAPL commands directly.

System Requirements

Minimum Requirements

OS: Windows 10, macOS 11, Ubuntu 18.04

RAM: 256 MB

Storage: 50 MB free space

Processor: Any 64-bit processor

Recommended

OS: Windows 11, macOS 13, Ubuntu 22.04

RAM: 1 GB or more

Storage: 200 MB free space

Processor: Multi-core 64-bit processor

Development Setup

Editor: VS Code, Vim, or any text editor

Git: For version control (optional)

Terminal: Command line access

Python: Not required (SAPL is standalone)

Troubleshooting

Common Installation Issues

"sapl" command not found

The SAPL executable is not in your system PATH.

  • Make sure you renamed the downloaded file to "sapl"
  • Verify the file is executable (chmod +x sapl on macOS/Linux)
  • Check that the directory containing sapl is in your PATH
  • Try running with full path: ./sapl --version

Permission denied on macOS/Linux

The file doesn't have execute permissions.

chmod +x sapl
bash

macOS security warning

macOS is blocking the unsigned application.

Go to System Preferences → Security & Privacy → General, and click "Allow" next to the SAPL message. Or run: sudo spctl --master-disable (not recommended for security).

Windows installer issues

If the Windows installer fails or doesn't add to PATH:

  • Run the installer as administrator
  • Manually add the installation directory to your PATH
  • Download the executable directly and follow manual setup steps

Need more help? Visit our GitHub issues page or join our community forum for support.

Next Steps

After installing SAPL successfully:

Learn the Basics
Start with fundamental SAPL concepts
Basic Syntax →
Try Tutorials
Hands-on learning with examples
Hello World Tutorial →
Explore Examples
See SAPL in action with real projects
Browse Tutorials →
Join Community
Connect with other SAPL developers
Join Community →
Getting StartedBasic Syntax