---
id: clandestined
version: "1.1.0"
license: MIT
license_treatment: permissive
maintenance: abandoned
---

# clandestined — rendezvous hashing implementation based on murmur3 hash

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

## What it is and what it does

Clandestined is a rendezvous hashing library designed to solve the problem of locating objects across a cluster of machines while minimizing data movement when nodes join or leave. It uses murmur3 hashing as its underlying algorithm and provides two main interfaces: a low-level RendezvousHash class for simple node-to-key mapping, and a higher-level Cluster class that adds zone awareness to spread replicas across failure domains.

The library is lightweight with no runtime dependencies and supports a wide range of Python versions from 2.5 through 3.8, including PyPy variants. It allows customization through seed parameters for hashing and configurable replica counts, making it suitable for both simple and zone-aware distributed systems.

Use it for:

- Locate cached data across a cluster of cache nodes while minimizing cache invalidation on node failures
- Distribute object replicas across multiple zones to ensure fault tolerance in geographically distributed systems
- Map incoming requests to backend servers in a load-balanced cluster with consistent routing
- Implement shard assignment in a distributed database where data must survive node departures

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Implements rendezvous hashing to locate objects across a cluster of machines, minimizing data movement when cluster topology changes.

Yes, if you need rendezvous hashing for a stable distributed system and can accept an abandoned library. The code is simple, has no dependencies, and carries no known vulnerabilities. However, verify compatibility with your Python version (support beyond 3.8 is unspecified) and be aware that no active maintenance means no future bug fixes or security updates.

## Install

pip install clandestined
uv add clandestined
poetry add clandestined

## Installing clandestined

Before you install: High install friction with no runtime dependencies. Maintenance status is abandoned—last release was 2023-06-01, over 1170 days ago. The repository is not archived but shows no active development.

License in practice: Licensed under MIT (permissive), so you may use, modify, and distribute freely with minimal restrictions.

Quickstart:

from clandestined import Cluster

nodes = {'1': {'name': 'node1.example.com', 'zone': 'us-east-1a'},
         '2': {'name': 'node2.example.com', 'zone': 'us-east-1a'}}
cluster = Cluster(nodes)
result = cluster.find_nodes('mykey')

Verify before relying:

- Whether the package works reliably on Python versions beyond 3.8, given the description lists support through 3.8 but provides no requires_python constraint
- Current stability and whether murmur3 hash implementation remains secure for production use in untrusted-input scenarios

## Package facts

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

## Tags

rendezvous hashing, consistent hashing, distributed object location, cluster node mapping, murmur3 hash, replica placement, zone-aware hashing, hashing, distributed-systems, cluster-management

[View on SkillFed](https://skillfed.io/packages/clandestined) · [View on PyPI](https://pypi.org/project/clandestined/)