Registry / database / hazelcast-python-client

hazelcast-python-client

library5.6.0pypypi✓ verified 85d ago

Python client for Hazelcast, an open-source in-memory data grid. Current version 5.6.0 (requires Python 3.11+). Released approximately quarterly.

database http-networking

pip install hazelcast-python-client

github ↗package ↗homepage ↗

INSTALL

IMPORT

SIG · HAZELCAST-PYTHON-C

hazelcast-python-client

databasepythonv5.6.0

Install

1.8s avg

Import

360ms

Disk

22MB

Pass rate

10/ 10

Env Coverage10 / 10

glibc

3.9–3.13

musl

3.9–3.13

Install & Compatibility

Where this runs

tested against v5.6.0 · pip install

no network on importno background threads

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

py 3.10–3.95 runs

installs and imports cleanly · install 0.0s · import 0.378s · 23.5MB

glibc

py 3.10–3.95 runs

installs and imports cleanly · install 1.8s · import 0.342s · 24MB

22MB installed

● package 22MB

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

HazelcastClient

✓ from hazelcast.client import HazelcastClient

✗ import hazelcast

hazelcast alone doesn't import client

ClientConfig

✓ from hazelcast.client import ClientConfig

✗ from hazelcast.config import ClientConfig

ClientConfig is in hazelcast.client

Connect to a Hazelcast cluster, use a distributed map.

from hazelcast.client import HazelcastClient, ClientConfig config = ClientConfig() config.cluster_name = os.environ.get('HZ_CLUSTER_NAME', 'hello-world') config.cluster_members = [os.environ.get('HZ_MEMBER_ADDRESS', '127.0.0.1:5701')] client = HazelcastClient(config) my_map = client.get_map('my-distributed-map') my_map.set('key', 'value').result() print(my_map.get('key').result()) client.shutdown()

Debug

Known issues

breakingAsync operations now require calling .result() on futures; direct await is only available in asyncio module (Beta).

fix

Use client.get_map('m').get('key').result() for synchronous, or switch to hazelcast.asyncio module.

affects: >=5.6.0

breakingPython 3.11 minimum required starting from v5.6.0.

fix

Upgrade Python to 3.11 or higher.

affects: >=5.6.0

gotchaDefault serialization uses Python pickle for unrecognized types, which can be a security risk when connecting to untrusted clusters.

fix

Configure a custom serialization serializer or allow only trusted clusters.

affects: all

Errors

Common errors & fixes

ImportError: cannot import name 'HazelcastClient' from 'hazelcast'

Common mistake: `import hazelcast` does not expose HazelcastClient.

fix

Use `from hazelcast.client import HazelcastClient`

AttributeError: 'Future' object has no attribute 'join'

Using threading.Thread's join incorrectly; Hazelcast futures use .result() not .join().

fix

Call `.result()` on the future to wait for the operation to complete.

hazelcast.errors.HazelcastClientNotActiveError: HazelcastClientNotActiveError()

Attempting operations after client.shutdown() or before client is fully connected.

fix

Ensure client lifecycle management: create client, perform operations, then shutdown.

Upgrade

Version history

5.6.0latest on PyPI · released Jan 16, 2026

Audit

Dependencies

hazelcast-kerberosoptionalKerberos authentication support

Agent activity

11 hits · last 30 days

node

Resources

githubhttps://github.com/hazelcast/hazelcast-python-client ↗

packagehttps://pypi.org/project/hazelcast-python-client/ ↗

homepagehttps://hazelcast.com ↗