# twitter-archive/gizzard

[Archived] A flexible sharding framework for creating eventually-consistent distributed datastores

Repository: https://github.com/twitter-archive/gizzard
Canonical: https://ross.abutalabs.com/products/gizzard
Language: Scala
License: Apache-2.0
License Family: permissive
Archived: true
Last push: 2017-03-16T23:21:54+00:00

## Health v2 (maintenance only)
Score: 10/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 0, release rhythm 35, longevity 100
- inputs: {"age_days": 5993, "days_push": 3457, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_releases, archived
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 2246, forks 206 (observed 2026-08-28T04:06:30.161601+00:00)

## What it is
Gizzard is a Scala sharding framework from Twitter for building custom, eventually-consistent distributed datastores. It acts as middleware that partitions data across arbitrary backend stores (e.g., SQL databases, Lucene) using forwarding tables and declarative replication trees.

## Use cases
- shard data across multiple backend databases
- build a custom distributed datastore
- replicate data across machines with fault tolerance
- partition large datasets that don't fit on one machine
- manage key-range-based routing to database partitions

## When to choose
- you need a flexible sharding layer over arbitrary backends on the JVM
- you want to build a custom eventually-consistent datastore rather than adopt a full distributed database

## When to avoid
- you need a maintained project - it is archived and unsupported by Twitter
- you want a turnkey distributed database rather than a framework to build one
- your stack is not JVM/Scala

## Facets
- artifact type: framework
- maturity: abandoned
- function: database, middleware, routing, message-queue
- domain: databases, microservices, backend, developer-tools
- platform: jvm
- tags: sharding, eventual-consistency, replication, datastore, archived, scala, linux, macos

## Member repositories
- twitter-archive/gizzard (main) score 10

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:06:30.161601+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-30T02:43:59.206058+00:00, confidence not recorded.
  - readme: https://github.com/twitter-archive/gizzard (fetched 2026-08-28T04:06:30.161601+00:00, sha de98716a2381)
- Data as of 2026-08-30T08:39:29.467469+00:00.