Installation
Atlas ships as a single static binary (macOS and Linux, amd64 and arm64), plus container images. Pick whichever fits.
Homebrew (macOS / Linuxbrew)
Section titled “Homebrew (macOS / Linuxbrew)”brew install orchestra-hq/tap/atlasOne-line installer
Section titled “One-line installer”The installer detects your OS/arch, downloads the matching release, and verifies its checksum and cosign signature before installing:
curl -fsSL https://raw.githubusercontent.com/orchestra-hq/atlas/main/install.sh | shIt is non-interactive and scriptable. Useful environment variables:
| Variable | Effect |
|---|---|
ATLAS_VERSION |
Install a specific tag (e.g. v0.1.0) instead of the latest |
ATLAS_INSTALL_DIR |
Install location (default /usr/local/bin, or ~/.local/bin) |
Container image
Section titled “Container image”# CPU (llama.cpp): the general defaultdocker run --rm -p 8080:8080 -v atlas-state:/var/lib/atlas \ ghcr.io/orchestra-hq/atlas:slim up --model qwen3-0.6b --addr 0.0.0.0:8080
# GPU (vLLM): requires the NVIDIA Container Toolkitdocker run --rm --gpus all -p 8080:8080 -v atlas-state:/var/lib/atlas \ ghcr.io/orchestra-hq/atlas:cuda up --engine vllm --model Qwen/Qwen3-8B --addr 0.0.0.0:8080See the Docker guide for image variants, state, and keys.
Verify
Section titled “Verify”atlas versionThen head to the quickstart.