.. _comms_protocols:

Communication Protocol: gRPC
============================

PyEDB exclusively uses the **gRPC Remote Procedure Calls (gRPC)** protocol to communicate with the ``ansys-edb-core``
service.

This modern framework is the foundation of PyEDB's architecture and offers key benefits:

*   **Headless Operation:** Enables operation on servers without a GUI (for example Linux, Docker).
*   **Performance:** High-speed communication, ideal for processing large, complex designs.
*   **Reliability:** Robust connection handling and error reporting.
*   **Decoupled Development:** The Python client and the core service can be updated independently.

Checking the Connection
-----------------------
You can always check the status and version of the connection from your Python script.

.. code-block:: python

   from pyedb import pyedb

   edb = Edb(edbpath="/tmp/my_project.aedb", version="2025.2", grpc=True)

If connection was successful, you should something similar to this in the console:

.. code-block:: console
   PyEDB INFO: Using PyEDB with gRPC as Beta until ANSYS 2025R2 official release.
   PyEDB INFO: Logger is initialized in EDB.