Installation
Prerequisites
aibox requires a container runtime on your host machine:
Podman (recommended)
# macOS
brew install podman
podman machine init
podman machine start
# Fedora / RHEL
sudo dnf install podman podman-compose
# Ubuntu / Debian
sudo apt install podman podman-compose
Docker
# macOS
brew install --cask docker
# Then launch Docker Desktop
# Linux — follow the official install guide
# https://docs.docker.com/engine/install/
aibox auto-detects which runtime is available. If both are installed, Podman takes priority.
Install script (recommended)
curl -fsSL https://raw.githubusercontent.com/projectious-work/aibox/main/scripts/install.sh | bash
Downloads the correct pre-built binary for your platform (Linux or macOS, x86_64 or ARM64) and installs it to ~/.local/bin/.
Options:
# Install a specific version
curl -fsSL .../install.sh | VERSION=0.8.0 bash
# Install to a custom directory
curl -fsSL .../install.sh | INSTALL_DIR=/usr/local/bin sudo -E bash
Manual download
Download the binary for your platform from the releases page:
# Example for macOS ARM64
tar xzf aibox-v0.8.0-aarch64-apple-darwin.tar.gz
mv aibox-v0.8.0-aarch64-apple-darwin ~/.local/bin/aibox
chmod +x ~/.local/bin/aibox
Available binaries:
| Platform | File |
|---|---|
| macOS ARM64 (Apple Silicon) | aibox-v0.8.0-aarch64-apple-darwin.tar.gz |
| macOS x86_64 (Intel) | aibox-v0.8.0-x86_64-apple-darwin.tar.gz |
| Linux ARM64 | aibox-v0.8.0-aarch64-unknown-linux-gnu.tar.gz |
| Linux x86_64 | aibox-v0.8.0-x86_64-unknown-linux-gnu.tar.gz |
Build from source
Requires a Rust toolchain:
git clone https://github.com/projectious-work/aibox.git
cd aibox
cargo install --path cli
Installs the binary to ~/.cargo/bin/.
Verify
aibox --version
# aibox 0.8.0
Shell completions
# Add to your shell profile for persistent completions:
# Bash (~/.bashrc)
eval "$(aibox completions bash)"
# Zsh (~/.zshrc)
eval "$(aibox completions zsh)"
# Fish (~/.config/fish/config.fish)
aibox completions fish | source