1. Install

Get atopile extension and KiCad set up

Just want to try atopile without installing anything? Check out the playground — it runs entirely in your browser.

Note: Nothing is saved between sessions. If you want to save your work, proceed with installing the extension.

The primary way to interact with atopile locally is via the VS Code extension. We also support forks like Cursor or Antigravity.

1. Install Preferred VS Code Fork

Editor	Download
VSCode	https://code.visualstudio.com/download
Cursor	https://cursor.com/download
Google Antigravity	https://antigravity.google/download

2. Install Extension

Once you have a VS Code editor, search for the extension or install by clicking atopile extension.

Once the extension is installed, you might see a popup for uv installing. Allow that to finish.

Complete!

You will now have a fresh new atopile icon in your sidebar. Click it to open the extension and get started.

3. Install KiCAD

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

macOS (brew)

brew install kicad

sudo pacman -S kicad

sudo apt install kicad

https://www.kicad.org/download/
# or click the KiCAD link above

4. Done!

Great! At this point you can move on and create your first project.

Other Install Methods (Optional)

Homebrew (recommended for macOS)

brew install atopile/tap/atopile

uv (recommended for other platforms)

1. Install uv

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

2. Clone the repo

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

3. cd into the repo

   cd atopile
   

4. Install

   uv sync --dev