> How to install Jitzu on your system

# Installation

Jitzu is distributed as a single standalone binary — `jz` — that serves as both the script interpreter and the interactive shell. Download the self-contained build for your platform — it bundles the .NET runtime, so it works on any machine with no prerequisites.

_See [Installation](/docs/getting-started/installation) for platform downloads._

## Package Managers

### Windows (WinGet)

WinGet is included with current versions of Windows 10 and Windows 11.

```powershell
winget install --id JitzuLang.Jitzu --exact
```

### Windows (Scoop)

```powershell
scoop bucket add jitzu https://github.com/jitzulang/jitzu
scoop install jz
```

## Self-Contained Binary

The self-contained binary bundles the .NET runtime, so it works on any machine with no
prerequisites. This is the easiest way to get started without a package manager.

### Windows

Download `jitzu-win-x64.zip` from the [latest GitHub release](https://github.com/jitzulang/jitzu/releases/latest). The following PowerShell commands extract it to a user-owned application directory and add that directory to your persistent user PATH without requiring administrator access.

```powershell
$dest = Join-Path $env:LOCALAPPDATA "Programs\\Jitzu"
New-Item -ItemType Directory -Force -Path $dest | Out-Null
Expand-Archive .\\jitzu-win-x64.zip -DestinationPath $dest -Force

$userPath = [Environment]::GetEnvironmentVariable("Path", "User")
$pathEntries = @($userPath -split ";" | Where-Object { $_ })
if ($pathEntries -notcontains $dest) {
    [Environment]::SetEnvironmentVariable(
        "Path",
        ($pathEntries + $dest) -join ";",
        "User"
    )
}
```

Restart your terminal after updating PATH, then run `jz --version` to verify the installation.

### macOS

Download `jitzu-osx-arm64.zip` (Apple Silicon) or `jitzu-osx-x64.zip` (Intel) from the [latest release](https://github.com/jitzulang/jitzu/releases/latest).

```bash
unzip jitzu-osx-arm64.zip
sudo mv jz /usr/local/bin/
chmod +x /usr/local/bin/jz
```

### Linux

Download `jitzu-linux-x64.zip` from the [latest release](https://github.com/jitzulang/jitzu/releases/latest).

```bash
unzip jitzu-linux-x64.zip
sudo mv jz /usr/local/bin/
chmod +x /usr/local/bin/jz
```

## Self-Update

Jitzu can update itself:

```bash
jz upgrade
```

## Build from Source

Jitzu requires the [.NET 10 SDK](https://dotnet.microsoft.com/download/dotnet/10.0) to build from source.

```bash
git clone https://github.com/jitzulang/jitzu.git
cd jitzu
dotnet build
dotnet run --project Jitzu.Shell -- --help
dotnet run --project Jitzu.Shell
```

## Verify Installation

Check the interpreter is on your PATH:

```bash
jz --version
# jz v0.2.0
```

Then launch the shell:

```shell
jz v0.2.0

• runtime    : 10.0.0
• config     : ~/.jitzu/config.jz
• platform   : Unix

Type \`help\` to get started.

> 1 + 1
2
```