Skip to content

Getting started

atopile brings the best of software development to the world of hardware design.

We're starting with an electronics compiler and a new language called ato. Files with the .ato extension can be used to describe your circuit, and compiles it to netlists that can be laid out and fabricated.

The .ato files are human readable and can be version controlled, so you can collaborate with your team on the design of your hardware. They're modular, so you can reuse components from other projects, and share them with the community. They provide a way to save the intelligence of your design and the validation required to make sure it works as intended, so you can be confident that your design will work as expected.


To run atopile, you will need the atopile compiler, the VSCode extension for syntax highlighting and git credential manager.

atopile is published as a python package on pypi. You can install it using pip from your command line. We recommend setting up a virtual environment for atopile so that atopile's dependencies don't clash with the rest of your system.

Start by making sure you have python@3.11 or later installed on your machine.

How to install python 3.11 or later

To install python 3.11 or later, you can use brew

brew install python@3.11

once you create your venv, make sure to run:

python3.11 -m venv venv

Setup the venv:

python3.11 -m venv venv
Activate the venv:
source venv/bin/activate

Now you can install atopile:

pip install atopile

atopile should be installed. You can verify that it worked with the following command which should give you the current version of atopile.

ato --version

Getting started with atopile - get setup and build your first project from scratch 32m – We have a video of how to install atopile and setup your project here.

atopile compiler - with git

atopile can be directly installed from GitHub by cloning the repository into a subfolder of your project root. This could be useful if you want to use the latest version of atopile:

git clone
This will create a repository with the latest version of atopile. You can install it using pip:

pip install -e atopile

VSCode extension - extension store

We recommend using VSCode to run atopile as it will provide syntax highlighting.

From VSCode, navigate to the VSCode extensions and install atopile.

Making a simple circuit

To get you started quickly, here is an example of a simple atopile circuit. See the rest of the documentation on how to fully use the atopile language features.

Let's build a voltage divider. Start by invoking ato create to create a new project.

Once created, open elec/src/your-project.ato and modify it in the following way:

import Resistor from "generics/resistors.ato"

module VoltageDivider:
    signal top
    signal out
    signal bottom

    r_top = new Resistor
    r_top.footprint = "R0402"
    r_top.value = 100kohm +/- 10%

    r_bottom = new Resistor
    r_bottom.footprint = "R0402"
    r_bottom.value = 200kohm +/- 10%

    top ~ r_top.p1; r_top.p2 ~ out
    out ~ r_bottom.p1; r_bottom.p2 ~ bottom

Now you can build this project and get a voltage divider!


The generics library should be installed by default in your-project/.ato/modules/generics directory. If not, run ato install generics