Support Redis Cluster

[riebecj]

Adds opt-in Redis Cluster support via rx.Config(redis_cluster=True), defaulting to False to preserve existing behavior. When enabled, Redis-backed state, locks, token ownership records, token scan/subscription patterns, and lost-and-found channels use stable hash-tagged Redis keys so related operations land in the same cluster slot.

The implementation keeps logical Reflex tokens, local cache/lock bookkeeping, and serialized payloads unchanged. Cluster key formatting/parsing is centralized in a small Redis key helper so Redis Cluster support stays transparent to the rest of the backend.

Also added a minor bug fix to the reflex_cli tests, where the tests fail on installed reflex version. When running the local editable version in-repo, it would fail. The version gets patched in the mock_check_version to bypass when testing.

All Submissions:

• Have you followed the guidelines stated in CONTRIBUTING.md file?
• Have you checked to ensure there aren't any other open Pull Requests for the desired changed?

Type of change

Please delete options that are not relevant.

• Bug fix (non-breaking change which fixes an issue)
• New feature (non-breaking change which adds functionality)

New Feature Submission:

• Does your submission pass the tests?
• Have you linted your code locally prior to submission?

Changes To Core Features:

• Have you added an explanation of what your changes do and why you'd like us to include them?
• Have you written new tests for your core changes, as applicable?
• Have you successfully ran tests with your changes locally?

[codspeed-hq]

Merging this PR will not alter performance

✅ 24 untouched benchmarks
⏩ 2 skipped benchmarks¹

---

_{Comparing riebecj:redis-cluster (140c01f) with main (2c9f76c)}

Footnotes

1. 2 benchmarks were skipped, so the baseline results were used instead. If they were deleted from the codebase, click here and archive them to remove them from the performance reports. ↩

[greptile-apps]

Greptile Summary

This PR adds opt-in Redis Cluster support via rx.Config(redis_cluster=True), keeping the default False to preserve existing behavior. When enabled, all Redis keys (state, locks, token ownership, scan/subscribe patterns, lost-and-found channels) are formatted with a stable SHA256-derived hash tag so related operations land in the same cluster slot.

• A new reflex/utils/redis_keys.py module centralises key formatting (format_redis_key) and stripping (logical_redis_key), keeping cluster logic out of the rest of the backend.
• StateManagerRedis and RedisTokenManager pick up the redis_cluster flag from config and route all key construction through the new helpers; channel-parsing code in the pub/sub handlers was updated to strip hash tags before looking up internal dictionaries.
• A minor test fix in conftest.py patches _reflex_version to prevent the CLI tests from failing against the local editable install.

Confidence Score: 4/5

Safe to merge; defaulting redis_cluster to False means zero impact on existing deployments, and the new code path is only exercised when explicitly opted in.

The change is well-structured: key formatting is centralised, pub/sub channel parsing correctly handles both cluster and non-cluster key shapes, and the oplock contention path produces the correct logical ident after the refactor. The only gaps are cosmetic — the SHA256 hash tag is 64 chars when a shorter value would serve equally well, and logical_redis_key uses a heuristic startswith guard that could misfire on edge-case key shapes in future callers.

reflex/utils/redis_keys.py — both the hash-tag length and the strip-heuristic are worth a second look before this code is reused in other contexts.

Important Files Changed

Filename	Overview
reflex/utils/redis_keys.py	New helper module for Redis Cluster key formatting; uses full SHA256 hex digest (64 chars) as hash tag which significantly bloats all cluster key names.
reflex/istate/manager/redis.py	Added redis_cluster field and refactored all key generation through _state_key/_lock_key helpers; channel parsing correctly handles both cluster and non-cluster key formats.
reflex/utils/token_manager.py	Added cluster-aware key methods (_get_redis_key_pattern, _token_from_redis_key); scan pattern and keyspace subscription pattern correctly target cluster-tagged keys.
packages/reflex-base/src/reflex_base/config.py	Added redis_cluster: bool = False option to BaseConfig, defaulting to False to preserve existing behavior.
tests/units/istate/manager/test_redis.py	New cluster tests verify hash tag sharing, tagged key storage, and non-BaseState token cluster behavior.

Flowchart

%%{init: {'theme': 'neutral'}}%%
flowchart TD
    A[Client Request] --> B[StateManagerRedis / RedisTokenManager]
    B --> C{redis_cluster?}
    C -- false --> D[logical_key]
    C -- true --> E[format_redis_key]
    E --> F[Redis Cluster]
    D --> G[Redis Single-Node]
    H[Incoming pubsub message] --> I[split channel at first colon]
    I --> J[logical_redis_key strips hash tag]
    J --> K[Look up in internal dicts by logical ident]

Loading

_{Reviews (1): Last reviewed commit: "Support Redis Cluster" | Re-trigger Greptile}