Getting Started#

To use PyMAPDL, you need to have a local installation of Ansys. The version of Ansys installed will dictate the interface and features available to you.

Visit Ansys for more information on getting a licensed copy of Ansys.


Python Module#

The ansys.mapdl.core package currently supports Python 3.6 through Python 3.9 on Windows, Mac OS, and Linux.

Install the latest release from PyPi with:

pip install ansys-mapdl-core

Alternatively, install the latest from PyMAPDL GitHub via:

pip install git+

For a local “development” version, install with:

git clone
cd pymapdl
pip install -e .

This will allow you to install the pymapdl ansys-mapdl-core module and modify it locally and have the changes reflected in your setup after restarting the Python kernel.

Offline Installation#

If you lack an internet connection on your install machine, the recommended way of installing PyMAPDL is downloading the wheelhouse archive from the Releases Page for your corresponding machine architecture.

Each wheelhouse archive contains all the python wheels necessary to install PyMAPDL from scratch on Windows and Linux for Python 3.7 and 3.9. You can install this on an isolated system with a fresh python or on a virtual environment.

For example, on Linux with Python 3.7, unzip it and install it with the following:

unzip wheelhouse
pip install ansys-mapdl-core -f wheelhouse --no-index --upgrade --ignore-installed

If you’re on Windows with Python 3.9, unzip to a wheelhouse directory and install using the same command as above.

Consider installing using a virtual environment.

Ansys Software Requirements#

For the latest features, you will need a copy of Ansys 2021R1 installed locally, but PyMAPDL is compatible with Ansys 17.0 and newer on Windows and 13.0 on Linux.


The latest versions of Ansys provide signifiantly better support and features. Certain features will not be supported by earlier versions of Ansys (e.g. APDL Math).

Verify Your Installation#

Check that you can start MAPDL from Python by running:

>>> from ansys.mapdl.core import launch_mapdl
>>> mapdl = launch_mapdl()
>>> print(mapdl)

Product:             ANSYS Mechanical Enterprise
MAPDL Version:       RELEASE  2021 R1           BUILD 21.0
PyMAPDL Version:     Version: 0.58.0

If you see a response from the server, congratulations! You’re ready to get started using MAPDL as a service. For details regarding the PyMAPDL interface, see PyMAPDL Language and Usage.