# topling/toplingdb

ToplingDB is a cloud native LSM Key-Value Store with searchable compression algo and distributed compaction

Repository: https://github.com/topling/toplingdb
Canonical: https://ross.abutalabs.com/products/toplingdb
Language: C++
License: GPL-2.0
License Family: copyleft
Topics: kvstore, rocksdb, distributed-database, compaction, nosql, database
Last push: 2026-08-31T15:48:34+00:00

## Health v2 (maintenance only)
Score: 81/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 100, release rhythm 45, longevity 100
- inputs: {"age_days": 2261, "days_push": 2, "days_rel": 155, "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 1017, forks 156 (observed 2026-09-01T02:14:08.067490+00:00)

## What it is
ToplingDB is a cloud-native persistent LSM key-value store forked from RocksDB, written in C++, featuring searchable compression algorithms and distributed compaction. It adds SidePlugin JSON/YAML configuration, an embedded HTTP server for live DB introspection and online option changes, and bindings for C++, Java, and Rust.

## Use cases
- embed a fast key-value store in a C++ application
- replace RocksDB with a faster LSM engine
- offload compaction to a distributed cluster
- configure database options via JSON/YAML without code changes
- monitor and tune a running KV store through a web UI
- store large values with compressed, searchable indexes

## When to choose
- you need an embedded LSM key-value store faster than RocksDB
- you want distributed compaction for large-scale workloads
- you want runtime reconfiguration and web-based DB introspection
- you need C++, Java, or Rust bindings for an embedded store

## When to avoid
- you need a permissively licensed database (ToplingDB is GPL-2.0, with some components under commercial/trial terms)
- you need a turnkey networked database rather than an embedded library
- your stack depends on vanilla RocksDB APIs and ecosystem tooling
- you need first-class Windows production support

## Facets
- artifact type: library
- maturity: active
- function: database, caching, serialization
- domain: databases, developer-tools, backend
- platform: cpp, cross-platform
- tags: key-value-store, lsm-tree, rocksdb-fork, cloud-native, distributed-compaction, searchable-compression, nosql, embedded-database, linux

## Member repositories
- topling/toplingdb (main) score 81

## Provenance
- Observed fields: from GitHub, fetched 2026-09-01T02:14:08.067490+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:11:15.242096+00:00, confidence not recorded.
  - readme: https://github.com/topling/toplingdb (fetched 2026-09-01T02:14:08.067490+00:00, sha 858b41df72de)
- Data as of 2026-08-30T08:39:29.467469+00:00.
