Getting started#

To use the ansys.grantami.bomanalytics package, you must have access to a Granta MI server that includes MI Restricted Substances and Sustainability Reports 2024 R1 or later.

The ansys.grantami.bomanalytics package currently supports Python 3.8 through 3.11 on Windows and Linux.


To install the latest release from PyPI, use this code:

pip install ansys-grantami-bomanalytics

To install a release compatible with a specific version of Granta MI, use the PyGranta meta-package with a requirement specifier:

pip install pygranta==2023.2.0

Alternatively, to install the latest from ansys-grantami-bomanalytics GitHub, use this code:

pip install git:

To install a local development version with Git and Poetry, use this code:

git clone
cd grantami-bomanalytics
poetry install

The preceding code installs the package and allows you to modify it locally, with your changes reflected in your Python setup after restarting the Python kernel.

Ansys software requirements#

You must have a working installation of Ansys Granta MI 2024 R1 or later with read access, along with an 2024 R1 or later installation of the MI Restricted Substances and Sustainability Reports Bundle.


MI Restricted Substances and MI Sustainability are licensed separately. Endpoints available to end users depend on the available licenses.

Verify your installation#

Check that you can start the BomServices Client from Python by running this code:

>>> from ansys.grantami.bomanalytics import Connection
>>> connection = Connection("").with_autologon().connect()
>>> print(connection)

<BomServicesClient: url="", dbkey="MI_Restricted_Substances">

If you see a response from the server, congratulations. You can start using the BomAnalytics service. For information about available queries, see Examples. For more in-depth descriptions, consult API reference.