Versions and interfaces#

The PyAEDT project attempts to maintain compatibility with legacy versions of AEDT while allowing for support of faster and better interfaces with the latest versions of AEDT.

There are two interfaces PyAEDT can use to connect to AEDT. You can see a table with the AEDT version and the supported interfaces in Table of supported versions

gRPC interface#

This is the default and preferred interface to connect to AEDT. Ansys 2022 R2 and later support the latest gRPC interface, allowing for remote management of AEDT with rapid streaming of mesh, results, and files from the AEDT service.

PyAEDT supports both secure and insecure gRPC connections. By default, secure connections are enabled using OS-native mechanisms (WNUA on Windows, UDS on Linux) for local connections, or mTLS for client-server scenarios.

For detailed information about secure gRPC connections, transport modes, version requirements, and configuration options, see Client-server.

gRPC interface for EDB#

Starting with AEDT 2025 R2, PyEDB supports gRPC connections for database access. By default, gRPC is enabled from 2026R1. This can be enabled using the settings:

from ansys.aedt.core.generic.settings import settings

settings.pyedb_use_grpc = True  # Enable PyEDB with gRPC (AEDT 2025 R2+)

Note

The pyedb_use_grpc setting requires AEDT 2025 R2 or later.

Legacy interfaces#

COM interface#

AnsysEM supports the legacy COM interface, enabled with the settings option.

This interface works only on Windows and uses .NET COM objects.

from ansys.aedt.core.generic.settings import settings

settings.use_grpc_api = False

Compatibility between AEDT and interfaces#

The following table shows the supported versions of Ansys EDT and the recommended interface for each one of them in PyAEDT.

Table of supported versions

Ansys Version

Recommended interface

Support

gRPC

COM

AnsysEM 2025 R1

gRPC

YES

NO*

AnsysEM 2024 R2

gRPC

YES

NO*

AnsysEM 2024 R1

gRPC

YES

NO*

AnsysEM 2023 R2

gRPC

YES

YES*

AnsysEM 2023 R1

gRPC

YES

YES*

AnsysEM 2022 R2

gRPC

YES*

YES

AnsysEM 2022 R1

gRPC

NO

YES

AnsysEM 2021 R2

gRPC

NO | YES

Where:

  • YES means that the interface is supported and recommended.

  • YES* means that the interface is supported, but not recommended. Their support might be dropped in the future.

  • NO means that the interface is not supported.

  • NO* means that the interface is still supported but it is deprecated.