---
id: redis-py-cluster
version: "2.1.3"
license: MIT
license_treatment: permissive
maintenance: abandoned
---

# redis-py-cluster — Library for communicating with Redis Clusters. Built on top of redis-py lib

License: permissive · Maintenance: abandoned · Downloads: 3.7M/mo

## 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 above — 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

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

- License: MIT (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: abandoned
- Downloads: 3.7M/month (top 5,000 on PyPI)
- Known vulnerabilities: none known

## Tags

redis cluster client, python redis cluster, redis cluster connection, distributed redis client, redis cluster library, redis cluster python, cluster-aware redis, redis-cluster, abandoned

[View on SkillFed](https://skillfed.io/packages/redis-py-cluster) · [View on PyPI](https://pypi.org/project/redis-py-cluster/)