> ## Documentation Index
> Fetch the complete documentation index at: https://atopile-fix-mcp-install-instructions.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 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/](https://www.cursor.com/)

Once you have VSCode/Cursor just install the [atopile VSCode/Cursor extension](vscode:extension/atopile.atopile).

<img src="https://mintcdn.com/atopile-fix-mcp-install-instructions/bPEjrOZGIAHd4X3v/atopile/images/vscode-plugin.png?fit=max&auto=format&n=bPEjrOZGIAHd4X3v&q=85&s=ac34eba011dcc8468edf181f3dd42131" alt="atopile extension" width="279" height="178" data-path="atopile/images/vscode-plugin.png" />

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

<img src="https://mintcdn.com/atopile-fix-mcp-install-instructions/bPEjrOZGIAHd4X3v/atopile/images/vscode-plugin-install-popup.png?fit=max&auto=format&n=bPEjrOZGIAHd4X3v&q=85&s=256c3b3d6dee2326b255655510125a1d" alt="atopile extension install" width="384" height="126" data-path="atopile/images/vscode-plugin-install-popup.png" />

<Accordion title="(Experimental) MCP server">
  Use the following to connect AI applications to this documentation

  <Tabs>
    <Tab title="URL">
      ```cURL
      https://docs.atopile.io/mcp
      ```
    </Tab>

    <Tab title="Cursor">
      [Install MCP Server](cursor://anysphere.cursor-deeplink/mcp/install?name=atopile-docs\&config=eyJ1cmwiOiJodHRwczogLy9kb2NzLmF0b3BpbGUuaW8vbWNwIn0%3D)
    </Tab>

    <Tab title="Claude Code">
      ```bash
      claude mcp add --transport http atopile-docs https://docs.atopile.io/mcp
      ```
    </Tab>
  </Tabs>
</Accordion>

## Installing KiCAD

If you want to layout or route PCBs you will need to install [KiCAD](https://www.kicad.org/download/).

<CodeGroup>
  ```sh macOS (brew)
  brew install kicad
  ```

  ```sh Arch Linux
  sudo pacman -S kicad
  ```

  ```sh Ubuntu
  sudo apt install kicad
  ```

  ```sh other
  https://www.kicad.org/download/
  # or click the KiCAD link above
  ```
</CodeGroup>

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` <small>(recommended for macOS)</small>

```sh
brew install atopile/tap/atopile
```

## `uv` <small>(recommended for other platforms)</small>

1. Install `uv`. See: [https://docs.astral.sh/uv/getting-started/installation/](https://docs.astral.sh/uv/getting-started/installation/)

2. Install atopile with `uv`

   ```sh
   uv tool install atopile
   ```

   <Warning>
     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.
   </Warning>

3. Check `ato` installed

   ```sh
   ato --version
   ```

### Editable installation (Best for development)

1. Install `uv`
   See: [https://docs.astral.sh/uv/getting-started/installation/](https://docs.astral.sh/uv/getting-started/installation/)

2. Clone the repo

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

3. `cd` into the repo

   ```sh
   cd atopile
   ```

4. Install

   ```sh
   uv sync --dev
   ```