Installation
How to install the Acme CLI via pip, Homebrew, or Docker, plus post-installation setup, shell completions, and upgrading.
Installation
Acme can be installed via pip, Homebrew, or Docker.
Using pip (recommended)
pip install acme-cli
Verify the installation:
acme --version
# Acme CLI v2.4.0
Using Homebrew (macOS)
brew tap acme/tap
brew install acme
Using Docker
docker pull acme/acme:latest
docker run --rm acme/acme:latest --version
[!warning] Python version Acme requires Python 3.10 or higher. If you're using an older version, consider using pyenv to manage multiple Python versions.
Post-installation setup
After installing, initialize your configuration:
acme init
This creates a ~/.acme/config.yml file with default settings. See Configuration for all available options.
Shell completions
Enable tab completions for your shell:
# Bash
acme completions bash >> ~/.bashrc
# Zsh
acme completions zsh >> ~/.zshrc
# Fish
acme completions fish > ~/.config/fish/completions/acme.fish
Upgrading
pip install --upgrade acme-cli
[!note] After upgrading, run
acme migrate upto apply any database schema changes. See the Changelog for breaking changes.
Next steps
Once installed, head to the Quickstart to build your first pipeline.