Awsum

Install

Get the awsum compiler, target runtimes, and editor tooling running on your machine.

Install

Prebuilt binaries from GitHub Releases

  1. Download into ~/.local/bin (overwrites any existing copy): 

    mkdir -p ~/.local/bin
curl -fsSL https://github.com/awsum-lang/awsum/releases/download/v0.0.6/awsum-0.0.6-macos-aarch64.tar.gz \
  | tar -xzC ~/.local/bin

  2. Verify install — ~/.local/bin must be on your PATH: 

    awsum --version

  1. Download into ~/.local/bin (overwrites any existing copy): 

    mkdir -p ~/.local/bin
curl -fsSL https://github.com/awsum-lang/awsum/releases/download/v0.0.6/awsum-0.0.6-linux-x86_64-gnu.tar.gz \
  | tar -xzC ~/.local/bin

  2. Verify install — ~/.local/bin must be on your PATH: 

    awsum --version

  1. Download into ~/.local/bin (overwrites any existing copy): 

    mkdir -p ~/.local/bin
curl -fsSL https://github.com/awsum-lang/awsum/releases/download/v0.0.6/awsum-0.0.6-linux-aarch64-gnu.tar.gz \
  | tar -xzC ~/.local/bin

  2. Verify install — ~/.local/bin must be on your PATH: 

    awsum --version

  1. Download into %LOCALAPPDATA%\Microsoft\WindowsApps — already on PATH by default since Windows 10 (overwrites any existing copy): 

    $Url  = "https://github.com/awsum-lang/awsum/releases/download/v0.0.6/awsum-0.0.6-windows-x86_64.zip"
$Dest = "$env:LOCALAPPDATA\Microsoft\WindowsApps"
Invoke-WebRequest -Uri $Url -OutFile "$env:TEMP\awsum.zip"
Expand-Archive -Path "$env:TEMP\awsum.zip" -DestinationPath $Dest -Force

  2. Verify install:

    awsum --version

For other platforms (musl Linux, x86 macOS, BSD), build from source — see awsum/CONTRIBUTING.md.

Target runtimes

Install only the runtimes for the targets you actually plan to use. 

# LLVM target — clang 15+ (opaque pointers)
brew install llvm@15

# JVM target — Java 11+
brew install openjdk

# CLR target — .NET 9+
brew install dotnet

# WASM target — wasmtime with WASI
brew install wasmtime

# JS target — Node 22+
brew install node
# LLVM target — clang 15+ (opaque pointers)
sudo apt-get install -y clang-15

# JVM target — Java 11+
sudo apt-get install -y default-jre

# CLR target — .NET 9+ (Ubuntu 24.04+; on older systems add
# Microsoft's APT repo first)
sudo apt-get install -y dotnet-sdk-9.0

# WASM target — wasmtime with WASI
curl https://wasmtime.dev/install.sh -sSf | bash

# JS target — Node 22+ via NodeSource (apt's default is older)
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt-get install -y nodejs
# LLVM target — clang 15+ (opaque pointers)
sudo apt-get install -y clang-15

# JVM target — Java 11+
sudo apt-get install -y default-jre

# CLR target — .NET 9+ (Ubuntu 24.04+; on older systems add
# Microsoft's APT repo first)
sudo apt-get install -y dotnet-sdk-9.0

# WASM target — wasmtime with WASI
curl https://wasmtime.dev/install.sh -sSf | bash

# JS target — Node 22+ via NodeSource (apt's default is older)
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt-get install -y nodejs
# LLVM target — clang 15.0.7 (opaque pointers; 16+ has known issues
# with our codegen on Windows runners)
$Url  = "https://github.com/llvm/llvm-project/releases/download/llvmorg-15.0.7/LLVM-15.0.7-win64.exe"
Invoke-WebRequest -Uri $Url -OutFile "$env:TEMP\llvm-installer.exe"
Start-Process -Wait "$env:TEMP\llvm-installer.exe" -ArgumentList "/S"

# JVM target — Java 11+
winget install EclipseAdoptium.Temurin.21.JDK

# CLR target — .NET 9+
winget install Microsoft.DotNet.SDK.9

# WASM target — wasmtime with WASI
winget install BytecodeAlliance.Wasmtime

# JS target — Node 22+
winget install OpenJS.NodeJS

Editor Support

Visual Studio Code

Syntax highlighting, formatting, inline diagnostics, quick fixes, outline, breadcrumbs, workspace symbols. Tested on Visual Studio Code; expected to work in other VSIX / Open VSX-compatible editors — Cursor, Windsurf, VSCodium, Positron, Trae, Theia.

IntelliJ IDEA

Syntax highlighting, formatting, inline diagnostics, quick fixes, outline, breadcrumbs, workspace symbols. Tested on IntelliJ IDEA 2026.x; expected to work in other IntelliJ-based IDEs — Rider, CLion, WebStorm, PyCharm, GoLand, RubyMine, PhpStorm, RustRover, DataGrip, DataSpell, Android Studio.

Zed

Syntax highlighting (Tree-sitter), formatting, inline diagnostics, quick fixes, outline, breadcrumbs, workspace symbols.

Neovim

Syntax highlighting (Tree-sitter), formatting, inline diagnostics, quick fixes, outline, breadcrumbs, workspace symbols. Requires Neovim 0.12+ and a C compiler — the bundled Tree-sitter parser is compiled on first use.

Emacs

Syntax highlighting (Tree-sitter), formatting, inline diagnostics, quick fixes, outline, workspace symbols. Requires Emacs 29.1+ and a C compiler — the Tree-sitter parser is cloned and compiled on first use.

Other editors

With awsum on your PATH, head to the docs for usage.