Skip to main content

​
Quick Install

The fastest way to install Soul is using our installation scripts.

​
macOS / Linux

Open your terminal and run: 
sh <(curl -fsSL https://soul-lang.com/install.sh)
Or with wget: 
sh <(wget -qO- https://soul-lang.com/install.sh)

​
Windows

Open PowerShell as Administrator and run: 
iwr -useb https://soul-lang.com/install.ps1 | iex

​
Manual Installation

If you prefer to install manually, follow these steps:

​
1. Download the Latest Release

Check the latest version at: https://github.com/gantz-ai/soul-release/blob/main/latest.txt Download the appropriate archive for your platform:

macOS (Apple Silicon)

mac/soul-VERSION-darwin-arm64.tar.gz

macOS (Intel)

mac/soul-VERSION-darwin-amd64.tar.gz

Linux

linux/soul-VERSION-linux-amd64.tar.gz

Windows

windows/soul-VERSION-windows-amd64.zip

​
2. Extract the Archive

  • macOS/Linux
  • Windows
tar -xzf soul-VERSION-PLATFORM.tar.gz

​
3. Install the Binary

  • macOS/Linux
  • Windows
# Rename to soul
mv soul-VERSION soul

# Make executable
chmod +x soul

# Move to PATH
sudo mv soul /usr/local/bin/

​
Verify Installation

After installation, verify Soul is working: 
soul version
You should see output like: 
Soul 1.0.0

​
Installation Locations

  • macOS/Linux
  • Windows
Soul is installed to /usr/local/bin/soulIf you need to uninstall:
sudo rm /usr/local/bin/soul

​
Updating Soul

Soul includes a built-in update command: 
# Check for updates and install if available
soul update

# Check for updates without installing
soul update --dry-run

​
Troubleshooting

If you get a permission error during installation, make sure to use sudo:
sudo mv soul /usr/local/bin/
If soul command is not found after installation:macOS/Linux: Add to your shell profile:
export PATH="$PATH:/usr/local/bin"
Windows: Restart your terminal or run:
refreshenv
If macOS blocks the executable, run:
xattr -d com.apple.quarantine /usr/local/bin/soul

​
Next Steps

Getting Started

Learn the basics of Soul programming

Language Guide

Explore Soul language features

Examples

See Soul in action with examples
⌘I