Installation

Ultimately atopile is a python package, so you can install it where and however you want - but some python package managers are better than others. Here's how we recommend you install atopile.

Homebrew brew (recommended for macOS)

brew install atopile/tap/atopile

uv (recommended for other platforms)

1. Install uv. See: https://docs.astral.sh/uv/getting-started/installation/

2. Install atopile with uv

   uv tool install atopile
   

   Important

   uv if this is the first time you've used uv for a tool install, it might give you another command to run to finish setup. Do it.

3. Check ato is installed

   ato --version
   

Editable installation (Best for development)

1. Install uv See: https://docs.astral.sh/uv/getting-started/installation/

2. Clone the repo

   git clone https://github.com/atopile/atopile
   

3. cd into the repo

   cd atopile
   

4. Install

   uv sync --dev