pyedb

library0.77.0pypypi✓ verified 86d ago

PyEDB is a higher-level Pythonic interface to Ansys Electronics Data Base (EDB), enabling programmatic access to EDB databases for PCB/IC packaging design and simulation. Current version is 0.74.0, released under an active development cadence with monthly or bi-monthly releases.

data serialization

pip install pyedb

github ↗package ↗docs ↗changelog ↗

INSTALL

IMPORT

SIG · PYEDB

pyedb

datapythonv0.77.0

Install

9.7s avg

Import

70ms

Disk

162MB

Pass rate

9/ 10

Env Coverage9 / 10

glibc

3.9–3.13

musl

3.9–3.13

Install & Compatibility

Where this runs

tested against v0.77.0 · pip install

no network on importno background threads

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

glibc

py 3.10

✓ —

✓ 10.1s

py 3.11

✓ —

✓ 8.6s

py 3.12

✓ —

✓ 7.4s

py 3.13

✓ —

✓ 7.8s

py 3.9

✕ build_error

✓ 14.7s

162MB installed

● package 162MB

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

Edb

✓ from pyedb import Edb

Main entry point for EDB database operations.

Hfss3dLayout

✓ from pyedb import Hfss3dLayout

Used for HFSS 3D Layout simulation setup.

Opens an EDB database from a file path. Replace '2024.1' with your Ansys version.

import os from pyedb import Edb # Initialize EDB (requires an active AEDT installation or gRPC connection) edb = Edb(edbpath=os.environ.get('EDB_PATH', ''), edbversion='2024.1') print('EDB loaded:', edb) edb.close()

Debug

Known issues

gotchaEDB requires a licensed Ansys AEDT installation or a running gRPC server. Without a valid license, operations will fail silently or raise obscure errors.

fix

Ensure AEDT is installed and licensed. For remote connections, start the gRPC server using 'aedt -grpc'.

affects: all

deprecatedDirect use of 'pyedb.Edb' with 'edbversion' parameter may be deprecated in future releases in favor of environment-aware initialization.

fix

Use 'Edb(edbpath=<path>)' without explicit version if environment variable 'ANSYSEM_VERSION' is set.

affects: >=0.70.0

breakingIn v0.69.0, the underlying gRPC API changed, breaking scripts that relied on internal 'edb.core' methods. Public API remains stable but low-level access is discouraged.

fix

Use public methods only; avoid direct calls to 'edb.core.<something>'.

affects: 0.69.0 - 0.74.0

Errors

Common errors & fixes

pyedb.exceptions.LicenseError: No valid license found for Electronics Desktop.

AEDT license server not reachable or no license available.

fix

Verify license server (set 'ANSYSLMD_LICENSE_FILE' or 'ANSYS_EM_DESKTOP_LIC' env var) or install/start a license manager.

OSError: [WinError 2] The system cannot find the file specified

AEDT executable path not found or not installed.

fix

Set 'ANSYSEM_ROOT<version>' environment variable to the AEDT installation directory, e.g., 'ANSYSEM_ROOT241' for 2024 R1.

AttributeError: 'Edb' object has no attribute 'open_layout'

Using an outdated code pattern from pyedb < 0.60. Open layout method was renamed.

fix

Use 'Edb.open_edb()' or 'Edb(edbpath=<path>)' to load an existing database. See documentation for layout-specific methods.

Upgrade

Version history

0.77.0latest on PyPI · released Jun 6, 2026

Audit

Dependencies

ansys-edb-corerequiredCore EDB gRPC API dependency

pyaedtrequiredRequired for launching Ansys AEDT and certain simulation workflows

Agent activity

19 hits · last 30 days

node

Resources

githubhttps://github.com/ansys/pyedb ↗

packagehttps://pypi.org/project/pyedb/ ↗

docshttps://edb.docs.pyansys.com ↗

changeloghttps://github.com/ansys/pyedb/releases ↗