Installation

Installation

Atlas is distributed as a Homebrew cask, public npm and GitHub Packages wrappers, release archives, and native Linux packages.

Homebrew

brew install --cask aziron-ai/atlas/atlas
atlas version

Homebrew names fully qualified casks as <owner>/<tap>/<cask>. The repository aziron-ai/homebrew-atlas becomes the tap aziron-ai/atlas; the cask and installed executable are both named atlas.

npm (public registry)

The public npm package needs no registry configuration or GitHub token:

npm install -g @aziron/atlas
atlas version

For a version-pinned installation:

npm install -g @aziron/atlas@0.1.43

GitHub Packages alternative

Organization CI that already uses GitHub Packages can install the equivalent @aziron-ai/atlas package. Point the scope at GitHub and use a token with read:packages:

npm config set @aziron-ai:registry https://npm.pkg.github.com
npm config set //npm.pkg.github.com/:_authToken YOUR_GITHUB_TOKEN
npm install -g @aziron-ai/atlas
atlas version

For a version-pinned installation:

npm install -g @aziron-ai/atlas@0.1.43

Both npm coordinates download the same native Atlas binary for the current platform. If you do not need npm specifically, Homebrew above is the simpler path on macOS and Linux.

Installation and Assistant Configuration

Homebrew and npm installations run Atlas bootstrap to register supported local assistant integrations. Inspect the proposed changes at any time:

atlas bootstrap --dry-run

To prevent npm post-install bootstrap in managed environments:

ATLAS_SKIP_BOOTSTRAP=1 npm install -g @aziron/atlas

Direct Release Archive

Choose the current version and platform from GitHub Releases:

VERSION=0.1.43
OS=darwin       # darwin or linux
ARCH=arm64      # arm64 or amd64
ASSET="atlas_${VERSION}_${OS}_${ARCH}.tar.gz"
BASE="https://github.com/aziron-ai/atlas/releases/download/v${VERSION}"

curl -fLO "$BASE/$ASSET"
curl -fLO "$BASE/checksums.txt"
grep " $ASSET\$" checksums.txt | shasum -a 256 -c -
tar -xzf "$ASSET"
sudo install -m 0755 atlas /usr/local/bin/atlas
atlas version

On Linux, replace the checksum command with sha256sum -c - when available.

Native Linux Packages

Each release includes .deb, .rpm, and .apk packages for amd64 and arm64. Download the matching package from the release page, then use the platform package manager:

# Debian or Ubuntu
sudo dpkg -i atlas_0.1.43_linux_amd64.deb

# Fedora or RHEL
sudo rpm -U atlas_0.1.43_linux_amd64.rpm

# Alpine
sudo apk add --allow-untrusted atlas_0.1.43_linux_amd64.apk

Supported Distribution Targets

Channel	Platforms
Homebrew	macOS/Linux amd64 and arm64
npm @aziron/atlas	macOS/Linux x64 and arm64; Windows x64
GitHub Packages @aziron-ai/atlas	macOS/Linux x64 and arm64; Windows x64
Release archive	macOS/Linux amd64 and arm64; Windows amd64
Linux package	.deb, .rpm, .apk; amd64 and arm64

Verify the Installation

command -v atlas
atlas version
atlas doctor --verify atlas

Continue with Getting Started.