# redis/lettuce

Advanced Java Redis client for thread-safe sync, async, and reactive usage. Supports Cluster, Sentinel, Pipelining, and codecs.

Repository: https://github.com/redis/lettuce
Canonical: https://ross.abutalabs.com/products/lettuce
Homepage: https://lettuce.io
Language: Java
License: MIT
License Family: permissive
Topics: java, redis, asynchronous, reactive, redis-sentinel, redis-cluster, azure-redis-cache, aws-elasticache, redis-client
Last push: 2026-08-26T08:09:28+00:00

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

## Adoption (not part of the score)
Stars 5776, forks 1103 (observed 2026-08-28T04:09:29.499373+00:00)

## What it is
Lettuce is a scalable, thread-safe Redis client for Java built on Netty, supporting synchronous, asynchronous, and reactive APIs. It provides advanced Redis features including Cluster, Sentinel, pipelining, auto-reconnect, SSL, and pluggable codecs.

## Use cases
- connect to redis from a java application
- use redis cluster with automatic topology discovery in java
- reactive redis streams with project reactor
- high-throughput redis pipelining from multiple threads
- failover to redis sentinel from a spring service
- serialize java objects to redis with custom codecs
- connect to aws elasticache or azure redis cache from jvm

## When to choose
- you need a thread-safe Redis client sharing one connection across threads
- you require reactive or async Redis access on the JVM
- your deployment uses Redis Cluster or Sentinel
- you want the default client behind Spring Data Redis

## When to avoid
- you need a simple blocking-only client and prefer a lighter API like Jedis
- your project is not on the JVM
- you rely heavily on blocking commands from shared connections, which Lettuce discourages

## Facets
- artifact type: library
- maturity: stable
- function: database-driver, caching, http-client
- domain: databases, backend, developer-tools
- platform: jvm, cross-platform
- tags: redis-client, netty, reactive-streams, redis-cluster, redis-sentinel, thread-safe, async

## Member repositories
- redis/lettuce (main) score 99

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:09:29.499373+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-29T17:52:51.799346+00:00, confidence not recorded.
  - readme: https://github.com/redis/lettuce (fetched 2026-08-28T04:09:29.499373+00:00, sha ba7d175a1d63)
- Data as of 2026-08-30T08:39:29.467469+00:00.
