redis-py-cluster

What it is and what it does

redis-py-cluster is a client library that abstracts Redis Cluster protocol handling, allowing Python applications to interact with Redis Cluster deployments as if they were a single logical Redis instance. It wraps redis and adds cluster-aware routing, slot management, and node discovery, so you can call standard Redis commands (set, get, etc.) and the client automatically routes them to the correct cluster node.

The package supports Python 2.7 through 3.8, though version 2.1.3 is the last release and the repository is now archived. It depends only on redis and provides a RedisCluster class that accepts a list of startup nodes for cluster discovery. Its abandonment means it will not receive bug fixes or compatibility updates for newer Redis Cluster features or Python versions.

Use it for:

• Connect a Python application to an existing Redis Cluster deployment for key-value operations across multiple nodes
• Perform pipelined commands against a Redis Cluster while automatically handling slot-to-node routing
• Read from replica nodes in a Redis Cluster to offload read traffic from primary nodes
• Implement cluster-aware pub/sub messaging in Python applications
• Migrate a single-node Redis client to a clustered setup without rewriting application logic

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Provides a Python client for Redis Cluster, enabling communication with Redis 3.0+ cluster deployments through a high-level API built on top of redis.

No, unless you are maintaining legacy code already using this package. The repository is archived and abandoned since 2023-08-24 with no updates since 2021-05-30. While it has no known vulnerabilities and low install friction, the lack of active maintenance means it will not receive updates for new Redis Cluster features, Python versions, or security issues. For new projects, use an actively maintained Redis Cluster client.

Install

redis-py-cluster on PyPI

pip install redis-py-cluster

uv add redis-py-cluster

poetry add redis-py-cluster

Installing redis-py-cluster

Before you install

Low install friction with a single runtime dependency (redis). However, the package is archived and abandoned as of August 2023, with no maintenance since the latest release on 2021-05-30. Use only if locked into an existing deployment; new projects should consider actively maintained alternatives.

License in practice

MIT license is permissive and imposes no significant restrictions on use, modification, or distribution. Suitable for both open-source and proprietary projects.

Quickstart

pip install redis-py-cluster

from rediscluster import RedisCluster

startup_nodes = [{"host": "127.0.0.1", "port": "7000"}]
rc = RedisCluster(startup_nodes=startup_nodes, decode_responses=True)
rc.set("foo", "bar")
print(rc.get("foo"))

Requires a running Redis Cluster (version 3.0+) with at least one accessible node for cluster discovery.

Verify before relying

• Whether redis compatibility remains reliable given the package's archived status and lack of recent updates
• Current stability with Redis Cluster versions released after 2021-05-30
• Whether connection pooling and failover scenarios remain robust without ongoing maintenance

Package facts

Evidence: redis_py_cluster-2.1.3-py2.py3-none-any.whl

Keywords: redis, redis cluster

Tags

More Database packages