Amoni is built on top of Docker which needs to be installed on your local machine.

As a minimum, you will need to install the Docker Engine and Docker Compose.

If you prefer, you can install the Docker Desktop App which also includes the Engine and Docker Compose.

Install Amoni

The recommended installation method is to use pipx:

pipx install amoni

If you prefer, you can install amoni into any Python environment using:

python -m pip install amoni

User Permissions

Make sure you add your user to the docker group. For example, on Linux:

sudo usermod -aG docker $USER
newgrp docker

If you don’t do this, you may get socket permission errors when you run “amoni start”.