​
Installation

This guide covers all installation options for AIUS.

​
CLI Installation

The CLI ships as a self-contained binary for macOS, Linux, and Windows — no Node, Bun, or Python required. 
curl -fsSL https://aius.co/install.sh | bash
The installer places the aius binary (and its bundled uv sidecar) in ~/.aius/bin and adds it to your PATH. Knobs:
  • AIUS_VERSION=vX.Y.Z — install a specific version instead of the latest release.
  • AIUS_INSTALL_DIR=/custom/path — install somewhere other than ~/.aius/bin.
Then run aius.

​
Web Interface

There is nothing to install — the web dashboard is a fully managed service. Sign in at aius.co/account to manage your account, API keys, and billing. See the Dashboard guide.

​
API

The AIUS API is a hosted service — you don’t install or run it yourself. The CLI talks to it automatically, and you can call it directly at https://aius.co/api/v1 with your AIUS API key. See the API reference.

​
Configuration

​
Signing in

On first launch the TUI lets you log in with your email and password, create an account, or paste an API key from your dashboard. The resulting token is stored at ~/.local/share/aius/auth.json (mode 0600); your password is never saved. You don’t manage an LLM provider key directly — model traffic is routed through the AIUS service, which holds the provider credentials server-side.

​
Environment variables (optional)

# Your AIUS key (alternative to the first-launch prompt)
AIUS_API_KEY=your_aius_key

# Point the client at a specific AIUS endpoint (defaults to the AIUS service)
AIUS_API_URL=https://aius.co/api/v1

​
Verification

aius --version

​
Troubleshooting

​
API key issues

Make sure you’re using a valid AIUS API key from your dashboard. If a key was revoked, generate a new one and re-enter it on the next launch (or update AIUS_API_KEY).

​
aius: command not found after installing

The installer adds ~/.aius/bin to your PATH via your shell profile — open a new terminal (or source your shell rc), or run the binary directly: ~/.aius/bin/aius.

​
”killed: aius” on macOS

Gatekeeper killed an unsigned copy of the binary. Reinstall with the official installer (it re-signs the binary in place); if you copied the binary around manually, run codesign -s - --force ~/.aius/bin/aius.

​
Alpine Linux: “musl system without libstdc++”

The Linux musl build needs libstdc++, which stock Alpine doesn’t include: 
apk add libstdc++ libgcc
Then re-run the installer.

​
Download failed during install

The installer prints the exact asset URL it tried. Check that your platform is supported (macOS arm64/x64, Linux x64/arm64 — glibc and musl, Windows x64) and that you can reach github.com. If the version lookup hits GitHub API rate limits, set GITHUB_TOKEN before running the installer.