# brainix/pottery

Redis for humans. 🌎🌍🌏

Repository: https://github.com/brainix/pottery
Canonical: https://ross.abutalabs.com/products/pottery
Language: Python
License: Apache-2.0
License Family: permissive
Topics: python, redis, redis-client, dict, distributed, lock, cache, forhumans, library, no-sql, redis-cache, bloom-filter, asyncio, distributed-lock, distributed-locks, resillience
Last push: 2026-08-25T13:43:32+00:00

## Health v2 (maintenance only)
Score: 67/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 99, release rhythm 8, longevity 100
- inputs: {"age_days": 4102, "days_push": 8, "days_rel": 530, "gap_med": null, "n_releases_24m": 1}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1245, forks 67 (observed 2026-08-28T04:04:07.062072+00:00)

## What it is
Pottery is a Pythonic Redis client library that wraps Redis data structures in familiar Python containers like dicts, sets, lists, and counters. It also provides distributed primitives such as Redlock locks, ID generators, caches, and Bloom filters for building resilient microservices.

## Use cases
- use redis like a python dict
- implement distributed locks in python
- add redis-backed caching to my app
- generate distributed unique ids
- use bloom filters with redis
- synchronize microservices with redis locks

## When to choose
- you want Redis access with Python-native container semantics
- you need battle-tested distributed locking or resilience primitives
- you want both sync and asyncio Redis lock support

## When to avoid
- you need raw access to all Redis commands
- your keys/values are not JSON serializable
- you use a language other than Python

## Facets
- artifact type: library
- maturity: active
- function: caching, database-driver, concurrency
- domain: databases, developer-tools, microservices
- platform: python
- tags: redis-client, distributed-lock, redlock, bloom-filter, pythonic-redis, asyncio, microservice-resilience, redis

## Member repositories
- brainix/pottery (main) score 67

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:04:07.062072+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T05:08:08.407874+00:00, confidence not recorded.
  - readme: https://github.com/brainix/pottery (fetched 2026-08-28T04:04:07.062072+00:00, sha 795217eeeca5)
  - registry_pypi: https://pypi.org/pypi/pottery/json (fetched 2026-08-29T12:19:34.127761+00:00, sha e206f2c6576e)
- Data as of 2026-08-30T08:39:29.467469+00:00.