Install Blue

Blue runs on macOS and Linux. There are two ways to install it.

With Homebrew

brew install bluelang-org/tap/blue

Homebrew installs Java for Blue if you don’t have it.

With a download

Each release has a download for each system, with its own Java inside, so you need nothing else:

System	File
macOS, Apple silicon	blue-VERSION-macos-arm64.tar.gz
macOS, Intel	blue-VERSION-macos-x64.tar.gz
Linux, x64	blue-VERSION-linux-x64.tar.gz
Linux, arm64	blue-VERSION-linux-arm64.tar.gz

Unpack it anywhere, and put its bin folder on your PATH:

tar xzf blue-VERSION-macos-arm64.tar.gz
export PATH="$PWD/blue-VERSION/bin:$PATH"

If you already have Java 25 or later, blue-VERSION.tar.gz is the same without Java.

Check it

blue doctor

blue doctor checks what Blue needs and says what to fix:

Blue 0.7.0, on Java 25.0.4+1 (/opt/homebrew/opt/openjdk/libexec/openjdk.jdk/Contents/Home)
  ok    Java: 25
  ok    SQLite: 3.53.4, for a program's own store
  ok    This folder: /Users/you/blue is writable, for a program's store
  warn  rqlite: not found; only clusters need it
        for blue cluster: brew install rqlite, or set BLUE_RQLITED to its rqlited
  ok    Settings: defaults (no blue.conf here)
  ok    AI provider: none configured (programs that call a model need ai.provider)
  ok    Confidential key: BLUE_CONFIDENTIAL_KEY not set (needed only to store Confidential values)
  ok    Extensions: Files, Http
Blue is ready; 1 optional thing is missing.

A warning is something optional; only clusters need rqlite, and you can add it later. Next: your first program.