Shows a black logo in light color mode and a white one in dark color mode.

PyPI Docs Packages Discord License

Design circuit boards with code

Write hardware like software. atopile is a language, compiler, and toolchain for electronics—declarative .ato files, deep validation, and layout that works natively with KiCad.

atopile editor with a project open

Why atopile

  • Reusable modules instead of starting from scratch every time
  • Capture intent with equations directly in your design
  • Automatic parametric picking of discrete components

Install

The easiest way is via the editor extension—it installs and manages ato for you:

Advanced setups and CLI installs: https://docs.atopile.io/atopile/guides/install

Quickstart (2 minutes)

  1. Install the extension (link above)

  2. In the editor, run “atopile: Open Example” and pick one

  3. Press the ▶ in the ato menu bar to build, or run ato build from the terminal

  4. Open layout when ready

Notes:

  • The ato menu bar is in the bottom-left of your VS Code/Cursor window
  • KiCad is optional to get started. Without it, you won’t open the PCB, but builds still run and update the .kicad_pcb. Install later when you’re ready for layout: https://docs.atopile.io/atopile/quickstart

How it works

  • ato is a declarative language for electronics: modules, interfaces, units, tolerances, and assertions
  • The compiler solves constraints, picks parts, runs checks, and updates your KiCad layout
  • The extension adds language services and one‑click controls

Learn more: https://docs.atopile.io/atopile/essentials/1-the-ato-language

Where atopile fits in

High-level steps:

  • Requirements — capture specs with units, tolerances, and assertions
  • Component selection — parametric picking, reuse proven modules
  • Design capture — .ato modules and interfaces compose your system
  • Layout — place and route in KiCad
  • Checks — run design checks locally or in CI
  • Build outputs — BOM, fabrication and assembly data, reports
  • PCB fab/assembly — send outputs to your manufacturer

Examples

Packages and parts

Compatibility

  • OS: macOS, Linux, Windows (WSL recommended)
  • Recommended editors: VS Code / Cursor
  • EDA: KiCad recommended for layout; not required to start

Contributing and development

pytest -q

Support

License

MIT. See LICENSE.

Project links

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (0.15.8)

Owner

PyPI data
Data sourced directly from PyPI's database.

Credits

Author: Matthew Wildoer

License

MIT License (MIT License)

Requires

Python <3.14, >=3.13

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

atopile-0.12.6.tar.gz (5.1 MB view details)

Uploaded Source

Built Distributions

If you're not sure about the file name format, learn more about wheel file names.

atopile-0.12.6-cp313-cp313-win_amd64.whl (1.1 MB view details)

Uploaded CPython 3.13Windows x86-64

atopile-0.12.6-cp313-cp313-musllinux_1_2_x86_64.whl (1.4 MB view details)

Uploaded CPython 3.13musllinux: musl 1.2+ x86-64

atopile-0.12.6-cp313-cp313-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl (927.6 kB view details)

Uploaded CPython 3.13manylinux: glibc 2.27+ x86-64manylinux: glibc 2.28+ x86-64

atopile-0.12.6-cp313-cp313-macosx_11_0_arm64.whl (877.9 kB view details)

Uploaded CPython 3.13macOS 11.0+ ARM64

atopile-0.12.6-cp313-cp313-macosx_10_13_x86_64.whl (893.4 kB view details)

Uploaded CPython 3.13macOS 10.13+ x86-64

File details

Details for the file atopile-0.12.6.tar.gz.

File metadata

  • Download URL: atopile-0.12.6.tar.gz
  • Upload date:
  • Size: 5.1 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for atopile-0.12.6.tar.gz
Algorithm Hash digest
SHA256 f49645a771004fbc9db9a46723c5c808bf98410b3a6b196defeca029027f6c74
MD5 df72e44a593097ed1b82086d38374cf1
BLAKE2b-256 29ac9127ae76d1605aaf6977cca8d81ad634bf7b153875ae1970e8726652b648

See more details on using hashes here.

Provenance

The following attestation bundles were made for atopile-0.12.6.tar.gz:

Publisher: deploy.yml on atopile/monopile

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file atopile-0.12.6-cp313-cp313-win_amd64.whl.

File metadata

  • Download URL: atopile-0.12.6-cp313-cp313-win_amd64.whl
  • Upload date:
  • Size: 1.1 MB
  • Tags: CPython 3.13, Windows x86-64
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for atopile-0.12.6-cp313-cp313-win_amd64.whl
Algorithm Hash digest
SHA256 ed5b22c15c83f41b8ffb69bd248114fcd1e8c207c6e6a108af377833e656930f
MD5 878f1ed173f40c26c3fca43fa146a6b7
BLAKE2b-256 d9041f61d699626eb0f23e57f583c97c45a24440e5c76250d47d0cd0c553263e

See more details on using hashes here.

Provenance

The following attestation bundles were made for atopile-0.12.6-cp313-cp313-win_amd64.whl:

Publisher: deploy.yml on atopile/monopile

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file atopile-0.12.6-cp313-cp313-musllinux_1_2_x86_64.whl.

File metadata

File hashes

Hashes for atopile-0.12.6-cp313-cp313-musllinux_1_2_x86_64.whl
Algorithm Hash digest
SHA256 a5676d444def6ce0c83220f1b2a1bb52ab7b248b544ccb9924689379ae257fbd
MD5 be1a74051fa4610035aa349a15570f6f
BLAKE2b-256 b6a5c520afb0ef00f4b9d9a4161601e1f7e871808ba374c860e5eb13170e5327

See more details on using hashes here.

Provenance

The following attestation bundles were made for atopile-0.12.6-cp313-cp313-musllinux_1_2_x86_64.whl:

Publisher: deploy.yml on atopile/monopile

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file atopile-0.12.6-cp313-cp313-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl.

File metadata

File hashes

Hashes for atopile-0.12.6-cp313-cp313-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 6499aa121ef1da5637cc6c2c801880c4b3ed16cd55de38d0ad1594166ae65fe1
MD5 2e8bc1fecffed969ad49197e32d0f9a2
BLAKE2b-256 8b593c28ed36716b1c8634b1ced22169f2ebe1c28020672cbe4b601419872ad0

See more details on using hashes here.

Provenance

The following attestation bundles were made for atopile-0.12.6-cp313-cp313-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl:

Publisher: deploy.yml on atopile/monopile

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file atopile-0.12.6-cp313-cp313-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for atopile-0.12.6-cp313-cp313-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 dda431e239e7dcb47fd6c08a1e959a266d098dae8b77fd775cb5fe3de7476520
MD5 0ac57ea3875b0771f7edcada82c5aeea
BLAKE2b-256 3de564a56bcadfc86ee2c213ab3064516e187bbb063d57fd50126548a2ad8b21

See more details on using hashes here.

Provenance

The following attestation bundles were made for atopile-0.12.6-cp313-cp313-macosx_11_0_arm64.whl:

Publisher: deploy.yml on atopile/monopile

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file atopile-0.12.6-cp313-cp313-macosx_10_13_x86_64.whl.

File metadata

File hashes

Hashes for atopile-0.12.6-cp313-cp313-macosx_10_13_x86_64.whl
Algorithm Hash digest
SHA256 df3a877777047ce4f283210ae300da70d588151c8a23fbb74376b604e17d4791
MD5 2e62d8489274fc7ea70200488be5f3a9
BLAKE2b-256 2c3d4a843a541e8bf18dc6cdda3fce0d154c70785e901c3a9304481dba34d2a2

See more details on using hashes here.

Provenance

The following attestation bundles were made for atopile-0.12.6-cp313-cp313-macosx_10_13_x86_64.whl:

Publisher: deploy.yml on atopile/monopile

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

0.15.8

0.15.7

0.15.6

0.15.5

0.15.4

0.15.3

0.15.2

0.15.1

0.15.0

0.14.1010

0.14.1009

0.14.1008

0.14.1007

0.14.1006

0.14.1005

0.14.1004

0.14.3

0.14.2

0.14.0

This release

0.12.6

0.12.5

0.12.4

0.12.3

0.12.2

0.12.1

0.12.0

0.11.8

0.11.7

0.11.6

0.11.5

0.11.4

0.11.3

0.11.2

0.11.1

0.11.0

0.10.23

0.10.22

0.10.21

0.10.20

0.10.19

0.10.18

0.10.17

0.10.16

0.10.15

0.10.14

0.10.13

0.10.12

0.10.11

0.10.10

0.10.9

0.10.8

0.10.7

0.10.6

0.10.5

0.10.4

0.10.3

0.10.2

0.10.1

0.10.0

0.9.8

0.9.7

0.9.6

0.9.5

0.9.4

0.9.3

0.9.2

0.9.1

0.9.0

0.8.2

0.8.1

0.8.0.dev0 pre-release

0.7.0

0.6.0

0.5.1

0.5.0

0.4.1

0.4.0.dev0 pre-release

0.3.24

0.3.23

0.3.22

0.3.21

0.3.20

0.3.19

0.3.18

0.3.17

0.3.16

0.3.15.dev0 pre-release

0.3.14.dev0 pre-release

0.3.13.dev0 pre-release

0.3.12.dev0 pre-release

0.3.11.dev0 pre-release

0.3.10.dev0 pre-release

0.3.9.dev0 pre-release

0.3.8.dev0 pre-release

0.3.7.dev0 pre-release

0.3.0.dev0 yanked

Reason this release was yanked:

Reverted the minor by providing compatability and re-releasing under patch

0.2.69

0.2.68

0.2.67

0.2.66

0.2.65

0.2.64

0.2.63

0.2.62

0.2.61

0.2.60

0.2.59

0.2.58

0.2.57

0.2.56

0.2.55

0.2.54

0.2.53

0.2.52

0.2.51

0.2.50

0.2.49

0.2.48

0.2.47

0.2.46

0.2.45

0.2.44

0.2.43 yanked

Reason this release was yanked:

Major bug in assertions

0.2.43.dev2 pre-release

0.2.43.dev1 pre-release

0.2.43.dev0 pre-release

0.2.42

0.2.42.dev0 pre-release

0.2.41

0.2.40

0.2.39

0.2.38

0.2.37

0.2.36

0.2.35

0.2.32

0.2.31

0.2.24

0.2.23

0.2.22

0.2.21

0.2.20

0.2.19

0.2.18

0.2.17

0.2.16

0.2.15

0.2.15.dev0 pre-release

0.2.14

0.2.13

0.2.12

0.2.12.dev1 pre-release

0.2.11

0.2.11.dev0 pre-release

0.2.10

0.2.9

0.2.8

0.2.7

0.2.7.dev0 pre-release

0.2.6

0.2.5

0.2.4

0.2.3

0.2.2

0.2.1

0.2.0

0.2.0.dev0 pre-release

0.1.7

0.1.6

0.0.22

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page