Installation

Aria is currently in v0.1 and supports macOS (ARM64) with LLVM-based compilation for other platforms.

Prerequisites

macOS (ARM64) for native compilation, or any platform with LLVM/Clang installed
Go 1.21+ (for the bootstrap compiler)
Clang (for LLVM IR compilation path)

Build from Source

Clone the repository and build the bootstrap compiler:

# Clone the Aria compiler
git clone https://github.com/aria-lang/aria.git
cd aria

# Build the Go bootstrap compiler
cd ../aria-compiler-go
go build -o aria ./cmd/aria

# Verify the installation
./aria --version

Compilation Targets

Aria supports two compilation backends:

Native ARM64 (macOS)

Direct machine code emission — no external tools needed. Produces Mach-O executables with proper code signing.

aria build src/main.aria --target arm64

LLVM IR (Cross-Platform)

Generates LLVM IR text, then compiles with Clang. Supports any architecture LLVM targets.

aria build src/main.aria --target llvm

Project Setup

Create a new Aria project with an aria.toml manifest:

[project]
name = "myapp"
version = "0.1.0"
aria = "0.1"
entry = "src/main.aria"

[deps]

[dev-deps]