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

Example Projects

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
  • Fast worktree setup (CoW-clone .venv + Zig cache/output, then path rewrite):
ato dev worktree <suffix>
cd ../atopile_<suffix>
source .venv/bin/activate
ato --help

By default this command starts an interactive shell in the new worktree. Pass --no-cd to skip shell handoff.

Support

License

MIT. See LICENSE.

Project links

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Latest release

Owner

PyPI data
Data sourced directly from PyPI's database.

Credits

Author: Ioannis Papamanoglou

License

MIT License (MIT License)

Requires

Python <3.15, >=3.14

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.15.9.tar.gz (95.6 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.15.9-cp314-cp314t-musllinux_1_2_x86_64.whl (12.8 MB view details)

Uploaded CPython 3.14tmusllinux: musl 1.2+ x86-64

atopile-0.15.9-cp314-cp314t-manylinux_2_28_x86_64.whl (12.8 MB view details)

Uploaded CPython 3.14tmanylinux: glibc 2.28+ x86-64

atopile-0.15.9-cp314-cp314t-macosx_11_0_arm64.whl (7.7 MB view details)

Uploaded CPython 3.14tmacOS 11.0+ ARM64

atopile-0.15.9-cp314-cp314t-macosx_10_15_x86_64.whl (8.1 MB view details)

Uploaded CPython 3.14tmacOS 10.15+ x86-64

atopile-0.15.9-cp314-cp314-win_amd64.whl (8.0 MB view details)

Uploaded CPython 3.14Windows x86-64

atopile-0.15.9-cp314-cp314-musllinux_1_2_x86_64.whl (12.8 MB view details)

Uploaded CPython 3.14musllinux: musl 1.2+ x86-64

atopile-0.15.9-cp314-cp314-manylinux_2_28_x86_64.whl (12.8 MB view details)

Uploaded CPython 3.14manylinux: glibc 2.28+ x86-64

atopile-0.15.9-cp314-cp314-macosx_11_0_arm64.whl (7.7 MB view details)

Uploaded CPython 3.14macOS 11.0+ ARM64

atopile-0.15.9-cp314-cp314-macosx_10_15_x86_64.whl (8.1 MB view details)

Uploaded CPython 3.14macOS 10.15+ x86-64

File details

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

File metadata

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

File hashes

Hashes for atopile-0.15.9.tar.gz
Algorithm Hash digest
SHA256 681cc1e123646dd133de31b631aedaf4eaac88682613b4f82d1da4b3ef8b4e8e
MD5 376d45fcfd19f098e728835418b773c7
BLAKE2b-256 ec707611a5fae81aab1f90ad071abd0861d6081606cfbd234ded5b8734dd94ff

See more details on using hashes here.

Provenance

The following attestation bundles were made for atopile-0.15.9.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.15.9-cp314-cp314t-musllinux_1_2_x86_64.whl.

File metadata

File hashes

Hashes for atopile-0.15.9-cp314-cp314t-musllinux_1_2_x86_64.whl
Algorithm Hash digest
SHA256 b3ca94ebd18a537763abaa7a8e907b96a2c0b4630afb7128ba2f2245a0e39187
MD5 508ae3b01c7ee1170a9e3f8933f7df41
BLAKE2b-256 7de34b0621461eb29fb4125b8fe8156cd9cac546ab5cba0b33c132efd6046bf6

See more details on using hashes here.

Provenance

The following attestation bundles were made for atopile-0.15.9-cp314-cp314t-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.15.9-cp314-cp314t-manylinux_2_28_x86_64.whl.

File metadata

File hashes

Hashes for atopile-0.15.9-cp314-cp314t-manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 7389bf20debb2da7efa86bb78a020ec89e7e5f185c966373fc8efaf00a12d1dd
MD5 338239e719f10733ccc57ab832d0ab4a
BLAKE2b-256 9db0dbba49de925d880b3a39c83b3b0172a9c08976c6efd2e9cbf19ccb00c41b

See more details on using hashes here.

Provenance

The following attestation bundles were made for atopile-0.15.9-cp314-cp314t-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.15.9-cp314-cp314t-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for atopile-0.15.9-cp314-cp314t-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 f3b023e4724f5a7f2e027a5d17151f634dffca6b22588df0f79f1e653d0eb65c
MD5 3d68405e110daf419b19fed5264993ab
BLAKE2b-256 2e67e087939afe6c43b169fa2ed9f3185bec8560dc0e3805956c926f40d9316e

See more details on using hashes here.

Provenance

The following attestation bundles were made for atopile-0.15.9-cp314-cp314t-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.15.9-cp314-cp314t-macosx_10_15_x86_64.whl.

File metadata

File hashes

Hashes for atopile-0.15.9-cp314-cp314t-macosx_10_15_x86_64.whl
Algorithm Hash digest
SHA256 3d36ea0c1c01b23c340bc4b871c031150be0b9fc14af0e3b3e76cebb8b1bf91e
MD5 831b5da27343f8d52f5e933644fd5a07
BLAKE2b-256 57d0e1f5654ca911df966ed7ca1462e999f9fb43db5f3017f533eb105b381c90

See more details on using hashes here.

Provenance

The following attestation bundles were made for atopile-0.15.9-cp314-cp314t-macosx_10_15_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.15.9-cp314-cp314-win_amd64.whl.

File metadata

  • Download URL: atopile-0.15.9-cp314-cp314-win_amd64.whl
  • Upload date:
  • Size: 8.0 MB
  • Tags: CPython 3.14, Windows x86-64
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for atopile-0.15.9-cp314-cp314-win_amd64.whl
Algorithm Hash digest
SHA256 ddb1f95468e901a68eac835fc68b301199e0eda0c7fed7ee9b6ec3df1a89d3f2
MD5 becfbbd55f88ba4133b89b3635ae37e6
BLAKE2b-256 68d8fc19d0922c968698b7bcd8a980bdf23f20a8814de089f7be211dc8f5513f

See more details on using hashes here.

Provenance

The following attestation bundles were made for atopile-0.15.9-cp314-cp314-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.15.9-cp314-cp314-musllinux_1_2_x86_64.whl.

File metadata

File hashes

Hashes for atopile-0.15.9-cp314-cp314-musllinux_1_2_x86_64.whl
Algorithm Hash digest
SHA256 e258762d05a46783b946e92f80961873740f7afaf3e662bdc5167a35220a67fd
MD5 64a3ad4cce39c35596570048846a04d4
BLAKE2b-256 3572c6b430e0f170ebd5ff7f2130fdd2b39ac51fb64e0905bc228a3da353182b

See more details on using hashes here.

Provenance

The following attestation bundles were made for atopile-0.15.9-cp314-cp314-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.15.9-cp314-cp314-manylinux_2_28_x86_64.whl.

File metadata

File hashes

Hashes for atopile-0.15.9-cp314-cp314-manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 9b1571061b74a8a098b354408d2e5d15cec962ff9dc75d72c22c00b8322fbffc
MD5 15caa96baa0b9bac417dbd5750ee6376
BLAKE2b-256 5cf6aca7bdcc80abbcf4c63b133232a930586270c07e358b5c6c2d85b7e21c7b

See more details on using hashes here.

Provenance

The following attestation bundles were made for atopile-0.15.9-cp314-cp314-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.15.9-cp314-cp314-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for atopile-0.15.9-cp314-cp314-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 085e43261f4c3af0ddfe49136992ff24b350d5356381be9154a2f439527d7be9
MD5 468ff6e2b7f952922dcaa654f0e07a1a
BLAKE2b-256 00a12c31fbcfdd2307c0fafc83e5d41fad4212d36373d4f715f6e9f609ff4cd9

See more details on using hashes here.

Provenance

The following attestation bundles were made for atopile-0.15.9-cp314-cp314-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.15.9-cp314-cp314-macosx_10_15_x86_64.whl.

File metadata

File hashes

Hashes for atopile-0.15.9-cp314-cp314-macosx_10_15_x86_64.whl
Algorithm Hash digest
SHA256 26ffc3f08e8d1b4540664d439bdbd57aea89eda02725a56840e8cbcc6f9044f5
MD5 0661f1d88b2c67975c3db6b7da4519ec
BLAKE2b-256 3eed348ca84beb11318eb0df657390b9820dc39926add3e5b8f923e46489fb71

See more details on using hashes here.

Provenance

The following attestation bundles were made for atopile-0.15.9-cp314-cp314-macosx_10_15_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

This release

0.15.9 This release

10 files

0.15.8

10 files

0.15.7

10 files

0.15.6

10 files

0.15.5

10 files

0.15.4

10 files

0.15.3

10 files

0.15.2

10 files

0.15.1

10 files

0.15.0

10 files

0.14.1010

10 files

0.14.1009

10 files

0.14.1008

10 files

0.14.1007

10 files

0.14.1006

10 files

0.14.1005

10 files

0.14.1004

10 files

0.14.3

10 files

0.14.2

10 files

0.14.0

10 files

0.12.6

6 files

0.12.5

6 files

0.12.4

6 files

0.12.3

6 files

0.12.2

6 files

0.12.1

6 files

0.12.0

6 files

0.11.8

6 files

0.11.7

6 files

0.11.6

6 files

0.11.5

6 files

0.11.4

6 files

0.11.3

6 files

0.11.2

6 files

0.11.1

6 files

0.11.0

6 files

0.10.23

6 files

0.10.22

6 files

0.10.21

6 files

0.10.20

6 files

0.10.19

6 files

0.10.18

6 files

0.10.17

6 files

0.10.16

6 files

0.10.15

6 files

0.10.14

6 files

0.10.13

6 files

0.10.12

6 files

0.10.11

6 files

0.10.10

6 files

0.10.9

6 files

0.10.8

6 files

0.10.7

6 files

0.10.6

6 files

0.10.5

6 files

0.10.4

6 files

0.10.3

6 files

0.10.2

6 files

0.10.1

6 files

0.10.0

6 files

0.9.8

6 files

0.9.7

6 files

0.9.6

6 files

0.9.5

6 files

0.9.4

6 files

0.9.3

6 files

0.9.2

6 files

0.9.1

6 files

0.9.0

6 files

0.8.2

6 files

0.8.1

6 files

Pre-release

0.8.0.dev0

6 files

0.7.0

6 files

0.6.0

6 files

0.5.1

6 files

0.5.0

6 files

0.4.1

6 files

Pre-release

0.4.0.dev0

6 files

0.3.24

5 files

0.3.23

5 files

0.3.22

5 files

0.3.21

5 files

0.3.20

5 files

0.3.19

5 files

0.3.18

5 files

0.3.17

5 files

0.3.16

5 files

Pre-release

0.3.15.dev0

5 files

Pre-release

0.3.14.dev0

5 files

Pre-release

0.3.13.dev0

5 files

Pre-release

0.3.12.dev0

5 files

Pre-release

0.3.11.dev0

5 files

Pre-release

0.3.10.dev0

5 files

Pre-release

0.3.9.dev0

5 files

Pre-release

0.3.8.dev0

5 files

Pre-release

0.3.7.dev0

5 files

Yanked

0.3.0.dev0

2 files

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

0.2.69

2 files

0.2.68

2 files

0.2.67

2 files

0.2.66

2 files

0.2.65

2 files

0.2.64

2 files

0.2.63

2 files

0.2.62

2 files

0.2.61

2 files

0.2.60

2 files

0.2.59

2 files

0.2.58

2 files

0.2.57

2 files

0.2.56

2 files

0.2.55

2 files

0.2.54

2 files

0.2.53

2 files

0.2.52

2 files

0.2.51

2 files

0.2.50

2 files

0.2.49

2 files

0.2.48

2 files

0.2.47

2 files

0.2.46

2 files

0.2.45

2 files

0.2.44

2 files

Yanked

0.2.43

2 files

Yanked reason: Major bug in assertions

Pre-release

0.2.43.dev2

2 files

Pre-release

0.2.43.dev1

2 files

Pre-release

0.2.43.dev0

2 files

0.2.42

2 files

Pre-release

0.2.42.dev0

2 files

0.2.41

2 files

0.2.40

2 files

0.2.39

2 files

0.2.38

2 files

0.2.37

2 files

0.2.36

2 files

0.2.35

2 files

0.2.32

2 files

0.2.31

2 files

0.2.24

2 files

0.2.23

2 files

0.2.22

2 files

0.2.21

2 files

0.2.20

2 files

0.2.19

2 files

0.2.18

2 files

0.2.17

2 files

0.2.16

2 files

0.2.15

2 files

Pre-release

0.2.15.dev0

2 files

0.2.14

2 files

0.2.13

2 files

0.2.12

2 files

Pre-release

0.2.12.dev1

2 files

0.2.11

2 files

Pre-release

0.2.11.dev0

2 files

0.2.10

2 files

0.2.9

2 files

0.2.8

2 files

0.2.7

2 files

Pre-release

0.2.7.dev0

2 files

0.2.6

2 files

0.2.5

2 files

0.2.4

2 files

0.2.3

2 files

0.2.2

2 files

0.2.1

2 files

0.2.0

2 files

Pre-release

0.2.0.dev0

2 files

0.1.7

2 files

0.1.6

2 files

0.0.22

2 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page