PyEDB
What is PyEDB?
PyEDB is a high-level Python API for processing complex and large layout designs in the Ansys Electronics Database (EDB) format, which stores information describing designs for Ansys Electronics Desktop (AEDT).
PyEDB is designed to make EDB automation easier to learn and faster to use. It provides high-level, application-oriented workflows for common layout tasks such as:
- opening and creating EDB projects,
- editing stackups and materials,
- working with components, nets, padstacks, and ports,
- building cutouts,
- and preparing designs for solver workflows.
For most users, the key point is simple:
PyEDB exposes high-level APIs intended to stay consistent across supported backends.
This means that most users can focus on the public PyEDB API and do not need to think about backend implementation details while getting started.
New user path
If you are new to PyEDB, follow this path:
- Install PyEDB
- Open or create a design with
Edb - Use the Getting started guide and examples
- Move to the User guide and API reference as needed
Install
pip install pyedb
Open an EDB project
from pyedb import Edb
edb = Edb(edbpath="myedb.aedb", version="2026.1")
# Your workflow here
# stackup, materials, components, nets, ports, padstacks, cutouts, ...
edb.close()
Advanced: explicitly choose a backend
Most users can work directly with the high-level PyEDB API and do not need to care about backend details.
If needed, backend selection is available through the grpc flag:
from pyedb import Edb
edb = Edb(edbpath="myedb.aedb", version="2026.1", grpc=False)
For backend-specific guidance, compatibility notes, and migration recommendations, see the dedicated backend / compatibility / migration documentation page.
About PyEDB
PyEDB is part of the larger PyAnsys effort to facilitate the use of Ansys technologies directly from Python. It is intended to consolidate and extend existing functionalities around scripting for EDB to allow reuse of existing code, sharing of best practices, and increased collaboration.
PyEDB includes functionality for interacting with Ansys electromagnetic simulators such as:
- HFSS,
- HFSS 3D Layout,
- Icepak,
- Maxwell,
- Q3D,
- and SIwave.
What is EDB?
EDB provides a proprietary database file format (AEDB) for efficient and fast layout design handling and processing for building ready-to-solve projects. EDB addresses signal integrity (SI), power integrity (PI-DC), and electro-thermal workflows.
You can import an AEDB file into AEDT to modify the layout, assign materials, and define ports, simulations, and constraints. You can then launch any of the Ansys electromagnetic simulators.
EDB runs as a standalone API, which means that you do not need to open a user interface (UI).
Because EDB opens the aedb folder for directly querying and manipulating layout design in
memory, it provides a fast and efficient way to handle large and complex layouts.
You can also parse an AEDB file from a command line in batch in an Ansys electromagnetic simulator such as HFSS or SIwave. Thus, you can deploy completely non-graphical flows, from layout translation through simulation results.
Additionally, you can use PyAEDT to import an AEDB file into AEDT to view a project, combine 3D designs, or perform simulation postprocessing. EDB also supports 3D component models.
Documentation and issues
Documentation for the latest stable release of PyEDB is hosted at PyEDB documentation: Learn how to install PyEDB, understand the basic concepts, and get started quickly.
- Installation: Install PyEDB and verify your environment.
- User guide: The user guide explains workflows and common tasks.
- API reference: API descriptions and usage details.
- Examples: Explore end-to-end workflow examples for PyEDB.
- Contribute: Learn how to contribute to the codebase or documentation.
If you need backend-specific guidance, platform recommendations, or migration planning, see the backend / compatibility / migration page in the documentation.
In the upper right corner of the documentation title bar, there is an option for switching from viewing the documentation for the latest stable release to viewing the documentation for the development version or previously released versions.
On the PyEDB Issues page you can create issues to report bugs and request new features.
On the PyEDB Discussions or the Ansys Developer Discussions page, you can post questions, share ideas, and get community feedback.
To reach the project support team, email pyansys.core@ansys.com.
Backend guidance
PyEDB exposes high-level APIs intended to be backend agnostic.
For most users, backend selection should remain a secondary concern. Beginner workflows and examples should focus on the public PyEDB API rather than backend implementation details.
Use the dedicated backend / compatibility / migration documentation page if you need guidance on:
- backend selection,
- platform considerations,
- compatibility validation,
- or migration planning.
License
PyEDB is licensed under the MIT License.
This library extends the functionality of EDB by adding a Python interface without changing the core behavior or license of the original software.
The use of PyEDB requires a legally licensed local copy of AEDT. To get a copy of AEDT, see the Ansys Electronics page on the Ansys website.
1 maintainer
Release files for pyedb 0.84.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| pyedb-0.84.1.tar.gz | 872.7 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| pyedb-0.84.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 2.1 MB
Release files / pyedb-0.84.1.tar.gz
| Download URL | pyedb-0.84.1.tar.gz |
|---|---|
| Size | 872.7 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
7c9f695711c9fac0d7e6d3a6c9852b3470337e806587ec74a73a10fe07b52b5e
|
|
BLAKE2b-256 checksum How to use checksums |
24dc7ac575336851b537d8ed5cf51cb98ce6d4a46a43328df614073a4b07a4ea
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 23, 2026.
Transparency logRelease files / pyedb-0.84.1-py3-none-any.whl
| Download URL | pyedb-0.84.1-py3-none-any.whl |
|---|---|
| Size | 1.2 MB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
29116ef22bd3d7ddd4da599cd054638396d9735a9012e77d6490798f0e2cc051
|
|
BLAKE2b-256 checksum How to use checksums |
a3f0ef4d7eee62b666e32ac2b835cb7dc61f165190144fb6bd2a92296c035b81
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 23, 2026.
Transparency log
