How to Install

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

Extract the ZIP file using Windows Explorer or:

Expand-Archive soul-VERSION-windows-amd64.zip

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/

Rename soul-VERSION.exe to soul.exe
Move to a directory in your PATH, or:
Add the directory containing soul.exe to your PATH environment variable

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

Soul is installed to %USERPROFILE%\.soul\bin\soul.exeThis directory is automatically added to your PATH.

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

Permission denied on macOS/Linux

If you get a permission error during installation, make sure to use sudo:

sudo mv soul /usr/local/bin/

Command not found

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

macOS security warning

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

Get Started

Essentials

Quick Install

macOS / Linux

Windows

Manual Installation

1. Download the Latest Release

macOS (Apple Silicon)

macOS (Intel)

Linux

Windows

2. Extract the Archive

3. Install the Binary

Verify Installation

Installation Locations

Updating Soul

Troubleshooting

Next Steps

Getting Started

Language Guide

Examples

​Quick Install

​macOS / Linux

​Windows

​Manual Installation

​1. Download the Latest Release

macOS (Apple Silicon)

macOS (Intel)

Linux

Windows

​2. Extract the Archive

​3. Install the Binary

​Verify Installation

​Installation Locations

​Updating Soul

​Troubleshooting

​Next Steps

Getting Started

Language Guide

Examples

Quick Install

macOS / Linux

Windows

Manual Installation

1. Download the Latest Release

2. Extract the Archive

3. Install the Binary

Verify Installation

Installation Locations

Updating Soul

Troubleshooting

Next Steps