PyTwin is a Python package for consuming a digital twin model that has been exported from Ansys Twin Builder as a TWIN file. Each TWIN file is a self-contained app (twin runtime) that consists of two parts:

• The twin model, which is the simulation model created and compiled in Twin Builder
• The runtime SDK, which is the shared library for consuming the twin model within the deployment workflow.

Because PyTwin wraps a twin runtime in a Python interface, you do not need a Twin Builder installation to deploy it.

For more information on digital twins and Ansys Twin Builder, see Digital Twins and Ansys Twin Builder on the Ansys website.

For comprehensive information on PyTwin, see the latest release Documentation and its sections:

• Getting started
• User guide
• API reference
• Examples
• Contributing

The pytwin package supports Python 3.9 through Python 3.12 on Windows and Linux.

Install the latest release from PyPI with this command:

pip install pytwin

If you plan on doing local development of PyTwin with Git, install the latest release with this code:

git clone https://github.com/ansys/pytwin.git
cd pytwin
pip install pip -U
pip install -e .

The pytwin package requires access to an Ansys License Server with the twin_builder_deployer feature available. For more information, see Getting started.

PyTwin is licensed under the MIT license.