Quickstart

Compiler release: GitHub release metadata. The current release, checksum status, and validation state are loaded from GitHub. Open current release.

Use this page for the shortest toolchain path. Use the handbook for exact language and compiler behavior.

Install

The installer resolves the current packaged compiler release from GitHub releases, uses published SHA-256 metadata when available, and adds the CLI to your PATH.

Linux x86_64 and macOS:

curl -fsSL https://ultraviolet-lang.org/install | sh

Windows x86_64:

powershell -c "irm https://ultraviolet-lang.org/install.ps1 | iex"

Ultraviolet’s CLI is named uv. If Astral’s Python package manager is already installed with the same command name, the installer asks whether to keep Python uv available as pyuv and install Ultraviolet as uv, or install Ultraviolet as uvc.

Minimal project

Create a project directory with an Ultraviolet.toml manifest and one source file.

Ultraviolet.toml
src/
  Main.uv

The manifest defines an executable assembly and the source root used by project loading. The canonical manifest behavior is owned by Project Root and Manifest.

[[assembly]]
name = "hello"
kind = "executable"
root = "src"

The entrypoint receives the executable context capability explicitly.

public procedure main(move ctx: Context) -> i32 {
    return 0
}

Commands

The public command surface is:

uv init
uv check
uv build
uv run
uv test
uv clean
uv version

Use uv check before uv build when validating examples. The command-line and tool-resolution rules are specified by Tool Resolution and IR Assembly Inputs.

Next

Read First Program for the smallest executable shape, then use the Handbook as the reference map for language features, diagnostics, grammar, and lowering behavior.