Skip to main content

GridGain binary client Python API

Project description


GridGain Community Edition thin (binary protocol) client, written in Python 3.


  • Python 3.7 or above (3.7, 3.8, 3.9 and 3.10 are tested),
  • Access to GridGain node, local or remote. The current thin client version was tested on GridGain CE 8.7 and 8.8 (binary client protocol 1.7.1).


From repository

This is a recommended way for users. If you only want to use the pygridgain module in your project, do:

$ pip install pygridgain

From sources

This way is more suitable for developers or if you install client from zip archive.

  1. Download and/or unzip GridGain Python client sources to gridgain_client_path
  2. Go to gridgain_client_path folder
  3. Execute pip install -e .
$ cd <gridgain_client_path>
$ pip install -e .

This will install the repository version of pygridgain into your environment in so-called “develop” or “editable” mode. You may read more about editable installs in the pip manual.

Then run through the contents of requirements folder to install the additional requirements into your working Python environment using

$ pip install -r requirements/<your task>.txt

You may also want to consult the setuptools manual about using

optional C extension

There is an optional C extension to speedup some computational intensive tasks. If it's compilation fails (missing compiler or CPython headers), pygridgain will be installed without this module.

  • On Linux or MacOS X only C compiler is required (gcc or clang). It compiles during standard setup process.

  • For building universal wheels (binary packages) for Linux, just invoke script ./scripts/

    NB! Docker is required.

  • On Windows MSVC 14.x required, and it should be in path, also python versions 3.7, 3.8, 3.9 and 3.10 both for x86 and x86-64 should be installed. You can disable some of these versions but you'd need to edit script for that.

  • For building wheels for Windows, invoke script .\scripts\BuildWheels.ps1 using PowerShell. Just make sure that your execution policy allows execution of scripts in your environment.

    Ready wheels for x86 and x86-64 for different python versions (3.7, 3.8, 3.9 and 3.10) will be located in distr directory.

Updating from older version

To upgrade an existing package, use the following command:

pip install --upgrade pygridgain

To install the latest version of a package:

pip install pygridgain

To install a specific version:

pip install pygridgain==1.4.0


The package documentation is available at RTD for your convenience.

If you want to build the documentation from source, do the developer installation as described above, then run the following commands:

$ pip install -r requirements/docs.txt
$ cd docs
$ make html

Then open <client_root_directory>/docs/generated/html/index.html in your browser.


Some examples of using pygridgain are provided in examples folder. They are extensively commented in the “Examples of usage” section of the documentation.

This code implies that it is run in the environment with pygridgain package installed, and GridGain node is running on localhost:10800.


NB! It is recommended installing pygridgain in development mode. Refer to this section for instructions.

Do not forget to install test requirements:

$ pip install -r requirements/install.txt -r requirements/tests.txt

Also, you'll need to have a binary release of Ignite with log4j2 enabled and to set IGNITE_HOME environment variable:

$ cd <gridgain_binary_release>
$ export IGNITE_HOME=$(pwd)
$ cp -r $IGNITE_HOME/libs/optional/ignite-log4j2 $IGNITE_HOME/libs/

Run basic tests

$ pytest

Run with examples

$ pytest --examples 

If you need to change the connection parameters, see the documentation on testing.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

pygridgain-1.4.0.tar.gz (265.2 kB view hashes)

Uploaded source

Built Distributions

pygridgain-1.4.0-cp310-cp310-win_amd64.whl (138.8 kB view hashes)

Uploaded cp310

pygridgain-1.4.0-cp310-cp310-win32.whl (137.9 kB view hashes)

Uploaded cp310

pygridgain-1.4.0-cp39-cp39-win_amd64.whl (138.8 kB view hashes)

Uploaded cp39

pygridgain-1.4.0-cp39-cp39-win32.whl (137.9 kB view hashes)

Uploaded cp39

pygridgain-1.4.0-cp38-cp38-win_amd64.whl (138.8 kB view hashes)

Uploaded cp38

pygridgain-1.4.0-cp38-cp38-win32.whl (137.8 kB view hashes)

Uploaded cp38

pygridgain-1.4.0-cp37-cp37m-win_amd64.whl (138.8 kB view hashes)

Uploaded cp37

pygridgain-1.4.0-cp37-cp37m-win32.whl (137.8 kB view hashes)

Uploaded cp37

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page