Install

How to install atopile

Install via VSCode/Cursor (Recommended)

atopile officially supports VSCode and Cursor.

We recommend using Cursor. AI is already getting very good at writing ato code.

Download it here: https://www.cursor.com/

Once you have VSCode/Cursor just install the atopile VSCode/Cursor extension.

After installation it will prompt you to install the ato CLI. Click the Install Automatically button.

(Experimental) MCP server

Use the following to connect AI applications to this documentation

URL

https://docs.atopile.io/mcp

Installing KiCAD

If you want to layout or route PCBs you will need to install KiCAD.

macOS (brew)

brew install kicad

Ultimately, atopile is a Python package, so you can install it wherever and however you want—but some Python package managers are better than others. Here’s the recommended method to 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
   

   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 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