# TiKV

Distributed transactional key-value database, originally created to complement TiDB

Repository: https://github.com/tikv/tikv
Canonical: https://ross.abutalabs.com/products/tikv
Homepage: https://tikv.org
Language: Rust
License: Apache-2.0
License Family: permissive
Topics: distributed-transactions, raft, rust, key-value, tikv, consensus, rocksdb, tidb, cncf, hacktoberfest
Last push: 2026-08-26T14:19:10+00:00
Link (homepage): https://tikv.org
Link (site_page): https://tikv.org/docs/dev/concepts/overview
Link (site_page): https://tikv.org/docs/7.1/concepts/overview
Link (site_page): https://tikv.org/docs/6.5/concepts/overview
Link (site_page): https://tikv.org/docs/6.1/concepts/overview

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

## Adoption (not part of the score)
Stars 16812, forks 2328 (observed 2026-08-28T04:11:17.322902+00:00)

## What it is
TiKV is an open-source, distributed, transactional key-value database written in Rust, using the Raft consensus algorithm and RocksDB for storage. Originally created by PingCAP as the storage layer for TiDB, it is a graduated CNCF project offering both raw and ACID-compliant transactional APIs with horizontal scalability.

## Use cases
- store metadata for object storage services
- build an online feature store for machine learning
- run a petabyte-scale distributed key-value store with ACID transactions
- serve as the storage backend for a MySQL-compatible NewSQL database
- deploy a geo-replicated low-latency key-value database
- store recommendation system data at scale

## When to choose
- you need horizontally scalable key-value storage with strong consistency and transactions
- you want a proven CNCF-graduated storage layer for large-scale online serving
- you need low, stable latency (sub-10ms P99) across 100+ TB of data

## When to avoid
- you only need a simple embedded or single-node key-value store
- you lack the operational capacity to run a multi-node distributed cluster
- you need rich SQL or document features without adding a query layer like TiDB

## Facets
- artifact type: service
- maturity: stable
- function: database
- domain: databases, microservices
- platform: rust, cloud
- tags: key-value, raft, cncf, tidb, rocksdb, geo-replication, horizontal-scaling, distributed-transactions, consensus, linux, docker, kubernetes

## Member repositories
- tikv/tikv (main) score 97
- tikv/raft-rs (sdk) score 60
- tikv/pd (backend) score 100

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:11:17.322902+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:03:49.519534+00:00, confidence not recorded.
  - readme: https://github.com/tikv/tikv (fetched 2026-08-28T04:11:17.322902+00:00, sha 408219737ef9)
  - homepage: https://tikv.org (fetched 2026-08-29T08:02:06.134058+00:00, sha 62c95ee543e8)
  - site_page: https://tikv.org/docs/dev/concepts/overview (fetched 2026-08-29T08:02:06.143060+00:00, sha f5fdbb4f9f85)
  - site_page: https://tikv.org/docs/7.1/concepts/overview (fetched 2026-08-29T08:02:06.145148+00:00, sha ce94be7dee39)
  - site_page: https://tikv.org/docs/6.5/concepts/overview (fetched 2026-08-29T08:02:06.146984+00:00, sha 931f4b508c5e)
  - site_page: https://tikv.org/docs/6.1/concepts/overview (fetched 2026-08-29T08:02:06.148757+00:00, sha 1fdc8e7a76e0)
  - site_page: https://tikv.org/docs/5.1/concepts/overview (fetched 2026-08-29T08:02:06.150593+00:00, sha 8188c9966537)
  - site_page: https://tikv.org/docs/4.0/concepts/overview (fetched 2026-08-29T08:02:06.152396+00:00, sha 34451a6e955c)
  - site_page: https://tikv.org/docs/3.0/concepts/overview (fetched 2026-08-29T08:02:06.154259+00:00, sha b820fc42ee21)
  - site_page: https://tikv.org/docs/7.1/new-features/overview (fetched 2026-08-29T08:02:06.156072+00:00, sha 1b34d800bb0e)
- Data as of 2026-08-30T08:39:29.467469+00:00.
