# geohot/minikeyvalue

A distributed key value store in under 1000 lines. Used in production at comma.ai

Repository: https://github.com/geohot/minikeyvalue
Canonical: https://ross.abutalabs.com/products/minikeyvalue
Language: Go
License: MIT
License Family: permissive
Last push: 2024-02-10T01:02:59+00:00

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

## Adoption (not part of the score)
Stars 3155, forks 261 (observed 2026-08-28T04:07:46.282872+00:00)

## What it is
A ~1000 line distributed key-value store written in Go, using nginx as volume servers and LevelDB for indexing, with replication and rebalancing support. It offers a simple HTTP API and partial S3 compatibility, and is used in production at comma.ai.

## Use cases
- store large binary blobs across multiple machines
- self-hosted S3-compatible object storage
- simple distributed key value store for petabyte-scale files
- replace complex distributed filesystems with something minimal
- replicated storage for files between 1MB and 1GB
- rebuildable index for blob storage on plain filesystems

## When to choose
- you want a tiny, auditable distributed storage system with a simple on-disk format
- you need to store large values (1MB-1GB) at scale with replication
- you prefer stock nginx volume servers and filesystem-based blob storage
- you want S3-library compatibility without running full S3

## When to avoid
- you need small-value, low-latency key-value access like Redis
- you need full S3 API coverage, erasure coding, or multi-tenancy
- you need strong consistency guarantees or built-in encryption
- you want a batteries-included storage product with a web UI

## Facets
- artifact type: service
- maturity: stable
- function: object-storage, http-server, database, caching
- domain: databases, microservices, infrastructure-as-code, self-hosted, developer-tools
- platform: go, self-hosted, cli
- tags: key-value-store, distributed-storage, s3-compatible, nginx, leveldb, blob-storage, object-storage, linux, docker

## Member repositories
- geohot/minikeyvalue (main) score 32

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:07:46.282872+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-30T07:25:39.208067+00:00, confidence not recorded.
  - readme: https://github.com/geohot/minikeyvalue (fetched 2026-08-28T04:07:46.282872+00:00, sha 9ae63275b070)
- Data as of 2026-08-30T08:39:29.467469+00:00.