Overview
PyMechanical is a Python interface for Ansys Mechanical (FEA software for structural engineering), enabling automation and integration of simulation workflows from 2024 R2 and later.
PyMechanical provides two distinct modes of interaction:
Embedding mode — Run Mechanical directly in your Python process via the App class. Full object-model access, fast startup, ideal for Jupyter notebooks and interactive scripting.
Remote session mode — Launch Mechanical as a separate server process and communicate via gRPC. Process isolation, optional GUI, ideal for CI/CD, Docker, and automation.
Compatibility
Python: 3.12 - 3.14
Mechanical: 2024 R2 (v242) and later
Platforms: Windows, Linux
Installation
Install from PyPI:
pip install ansys-mechanical-core
For graphics support:
pip install ansys-mechanical-core[graphics]
For RPC functionality:
pip install ansys-mechanical-core[rpc]
For AI assistant integration via the Model Context Protocol (MCP):
pip install ansys-mechanical-core[mcp]
Requirements:
Licensed copy of Ansys Mechanical (2024 R2 or later).
For embedded mode: Local Mechanical installation required.
For remote session mode: Network access to a running Mechanical instance.
Quick start
Embedding mode:
from ansys.mechanical.core import App
app = App(globals=globals())
print(app)
# Access Mechanical objects directly
Model.AddStaticStructuralAnalysis()Remote session mode:
from ansys.mechanical.core import launch_mechanical
mechanical = launch_mechanical()
result = mechanical.run_python_script("2+3")
print(result) # Output: 5
mechanical.exit()Connect to existing instance:
from ansys.mechanical.core import connect_to_mechanical
mechanical = connect_to_mechanical(port=10000)
result = mechanical.run_python_script("Model.Name")
print(result)Troubleshooting
Connection refused: Ensure Mechanical is running and the port is accessible.
License error: Verify your Ansys license is properly configured.
Import error: Check that ansys-pythonnet is installed (not pythonnet).
Linux embedding: Use mechanical-env to run Python scripts for embedded mode.
Documentation and support
PyMechanical-MCP — AI assistant integration via MCP
Issues — report bugs or request features
Discussions — ask questions
1 maintainer
Metadata
1 maintainer
Release files for ansys-mechanical-core 0.13.4
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| ansys_mechanical_core-0.13.4.tar.gz | 106.0 kB | With provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| ansys_mechanical_core-0.13.4-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 268.7 kB
Release files / ansys_mechanical_core-0.13.4.tar.gz
| Download URL | ansys_mechanical_core-0.13.4.tar.gz |
|---|---|
| Size | 106.0 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
f3d7fbff2417ea0443cb4e54374f556ab05406f74fe712fa6f8a2783c7b3e8f1
|
|
BLAKE2b-256 checksum How to use checksums |
8b0878cbf43d262c7058edd227953dacd270a0dea4c0d9e88344f1cfc6cabb78
|
| 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 Oct 12, 2026.
Transparency logRelease files / ansys_mechanical_core-0.13.4-py3-none-any.whl
| Download URL | ansys_mechanical_core-0.13.4-py3-none-any.whl |
|---|---|
| Size | 162.7 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
704249c4a3669d3a31716776110df1568e3d5e7dcb42574eb71314ab81d20e72
|
|
BLAKE2b-256 checksum How to use checksums |
b22fa5b1497e418124f774b2eaa8141d812b69392396cefc7f86102365325d85
|
| 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 Oct 12, 2026.
Transparency logSecurity for ansys-mechanical-core 0.13.4
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.
Full provenance
All 2 files in this release have been uploaded with provenance metadata.
Attestation for ansys_mechanical_core-0.13.4.tar.gz
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 Oct 12, 2026.
Transparency logA note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.
