System Requirements

  • macOS 12+ or Linux (x86_64 / ARM64)
  • Windows 10+ (PowerShell)
  • Node.js 18+ (for npm installation)
  • Rust 1.75+ (for building from source)

Installation Methods

curl (macOS / Linux)

The fastest way to install:

curl -fsSL https://alius.tech/install | sh

Windows PowerShell

irm https://alius.tech/install.ps1 | iex

npm

Install globally via npm:

npm install -g @alius-tech/alius

How the npm package works:

  1. Detects process.platform and process.arch
  2. Resolves the corresponding platform binary package or local development binary
  3. Launches the native alius binary
  4. Forwards stdio and process signals

Supported platform packages are installed automatically with the @alius-tech/alius main package.

Homebrew

brew tap AliusTech/tap
brew install alius

Build from Source

git clone https://github.com/AliusTech/alius.git
cd alius
cargo build --release

The binary is located at ./target/release/alius.

Verify Installation

alius --version

Confirm that the version number is output correctly.

Global Parameters

You can use the following global parameters before any Alius command:

ParameterPurposeNotes
--model <model>Override the default model for the current commandalius run --model is the most explicit consumption path
--provider <provider>Override the default providerSome distribution paths may not consume this parameter
--workspace <path>Specify the workspace directorySome distribution paths may not consume this parameter
--config <path>Specify a custom configuration fileThe main distribution currently calls Settings::load() directly
--verboseSet log verbosityLog behavior depends on the actual code path

Global parameters are declared in the CLI type definitions, but not all distribution paths consume every parameter. For example, alius run --model is the most explicit one-shot model override parameter.

Next Steps