Install Scarp v0.0.5-alpha.4

This historical guide installs the published alpha.4 compiler prerelease: v0.0.5-alpha.4 (November 3, 2026), from source commit 79141329176f5dce51457e90a6652902f6432135. Scarp is an experimental interpreter, not a stable language or native .srp executable compiler.

1. Choose your official download

All seven listed assets (three archives, their three individual checksums, and SHA256SUMS) were present on the official published release when this guide was prepared. Use only the archive matching your OS/CPU. There is no published Windows ARM64, Linux ARM64, or Intel macOS archive for this release; building from source may be an alternative if a supported Rust target and the necessary build tools are available.

Download both the archive and its .sha256 file to the same folder. Run the matching commands below from that folder. The checksum contains the expected SHA-256 digest and archive name; compare or check it before extracting or running anything. Obtain checksums from the official GitHub release, not an unrelated mirror. A matching checksum verifies downloaded bytes against the release's posted checksum, not the safety of arbitrary third-party binaries.

2. Windows x64 — PowerShell

Use PowerShell (not Command Prompt). The script reads the official checksum, compares the calculated archive hash, and stops before extraction if the values differ. It then enters the package's actual nested directory:

$archive = 'scarp-0.0.5-alpha.4-x86_64-pc-windows-msvc.zip'
$expected = ((Get-Content "$archive.sha256" -Raw).Trim() -split '\s+')[0]
$actual = (Get-FileHash -LiteralPath $archive -Algorithm SHA256).Hash
if ($actual -ine $expected) { throw 'SHA-256 mismatch: stop' }
Expand-Archive -LiteralPath $archive -DestinationPath '.\scarp-alpha4'
Set-Location '.\scarp-alpha4\scarp-0.0.5-alpha.4-x86_64-pc-windows-msvc'
.\scarp.exe version
.\scarp.exe create hello-world
.\scarp.exe verify hello-world
.\scarp.exe launch hello-world

You should see version 0.0.5-alpha.4, followed by the starter project's output Hello from Scarp!. Using .\scarp.exe avoids accidentally running an older scarp from your PATH.

3. Linux x64 — Bash

On a Linux x64 system with the required native runtime support, run:

sha256sum --check scarp-0.0.5-alpha.4-x86_64-unknown-linux-gnu.tar.gz.sha256
mkdir -p scarp-alpha4
tar -xzf scarp-0.0.5-alpha.4-x86_64-unknown-linux-gnu.tar.gz -C scarp-alpha4
cd scarp-alpha4/scarp-0.0.5-alpha.4-x86_64-unknown-linux-gnu
./scarp version
./scarp create hello-world
./scarp verify hello-world
./scarp launch hello-world

sha256sum --check must report OK before extraction. The publisher's archive contains the named package folder and the executable scarp inside it.

4. macOS Apple Silicon — Terminal

On a Mac with an Apple Silicon CPU, use:

shasum -a 256 -c scarp-0.0.5-alpha.4-aarch64-apple-darwin.tar.gz.sha256
mkdir -p scarp-alpha4
tar -xzf scarp-0.0.5-alpha.4-aarch64-apple-darwin.tar.gz -C scarp-alpha4
cd scarp-alpha4/scarp-0.0.5-alpha.4-aarch64-apple-darwin
./scarp version
./scarp create hello-world
./scarp verify hello-world
./scarp launch hello-world

On macOS, shasum -a 256 -c checks the published SHA-256 file. The macOS package is ARM64; it is not advertised as a native Intel macOS build. If macOS blocks execution, inspect the downloaded file's origin and your system's security message rather than disabling protections blindly.

5. Alternatively, build the exact published source

Install a compatible Rust toolchain and Cargo first (see rustup). On Windows use an MSVC Rust toolchain and its required build tools. Build the tagged source, not a moving main branch; each sequence checks the expected 40-character source commit before building.

Linux or macOS:

git clone https://github.com/scarp-lang/scarp.git
cd scarp
git checkout v0.0.5-alpha.4
test "$(git rev-parse HEAD)" = "79141329176f5dce51457e90a6652902f6432135" || exit 1
cargo build --locked
./target/debug/scarp version

Windows PowerShell:

git clone https://github.com/scarp-lang/scarp.git
Set-Location scarp
git checkout v0.0.5-alpha.4
if ((git rev-parse HEAD).Trim() -ne '79141329176f5dce51457e90a6652902f6432135') { throw 'Unexpected source commit' }
cargo build --locked
.\target\debug\scarp.exe version

cargo build compiles the Rust-based Scarp interpreter. It does not compile a .srp program into a native binary. The published release provides no package manager or dependency installer for Scarp projects.

6. Diagnose version and installation problems

After the first successful launch, see the alpha.4 project tutorial, CLI reference, compatibility guide, and troubleshooting.

Evidence: published release assets, tagged packaging script, tagged release verifier and compiler source at the release tag. The documentation CI checks the exact commands and bilingual parity, while tagged compiler CI validates project behavior.