Getting started#

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

The ansys.grantami.bomanalytics package currently supports Python 3.7 through 3.10 on Windows and Linux.


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

pip install ansys-grantami-bomanalytics

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#

For the latest features, you must have a working installation of Ansys Granta MI 2022 R1 or later with read access, along with an 2022 R1 or later installation of the MI Restricted Substances Reports Bundle.

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.