# otoolep/hraftd

A reference use of Hashicorp's Raft implementation

Repository: https://github.com/otoolep/hraftd
Canonical: https://ross.abutalabs.com/products/hraftd
Homepage: http://www.philipotoole.com/building-a-distributed-key-value-store-using-raft/
Language: Go
License: MIT
License Family: permissive
Topics: distributed-systems, raft, hashicorp-raft, key-value, go, consensus
Last push: 2026-08-16T01:22:01+00:00

## Health v2 (maintenance only)
Score: 76/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 97, release rhythm 35, longevity 100
- inputs: {"age_days": 3990, "days_push": 18, "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 1098, forks 142 (observed 2026-08-28T04:03:34.916511+00:00)

## What it is
hraftd is a reference implementation of a distributed key-value store built on Hashicorp's Raft consensus library in Go. It serves as a simple, runnable example for studying the Raft consensus protocol and fault-tolerant distributed systems.

## Use cases
- learn how the raft consensus protocol works
- build a distributed key-value store in go
- example of using hashicorp raft library
- study fault-tolerant distributed systems
- set up a multi-node raft cluster for experimentation
- reference code for building consensus-based systems

## When to choose
- you want a minimal, readable example of Hashicorp's Raft library in action
- you are learning distributed consensus and want a runnable demo
- you need a starting point for building your own Raft-based Go application

## When to avoid
- you need a production-ready distributed database
- you want a full-featured key-value store with persistence guarantees beyond the demo
- you are not working in Go or with the Hashicorp Raft library

## Facets
- artifact type: application
- maturity: stable
- function: http-server, developer-tools
- domain: microservices, databases, developer-tools, tutorials
- platform: windows, go, cli
- tags: raft, consensus, hashicorp-raft, key-value-store, reference-implementation, learning, linux, macos

## Member repositories
- otoolep/hraftd (main) score 76

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:03:34.916511+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-30T06:46:19.946041+00:00, confidence not recorded.
  - readme: https://github.com/otoolep/hraftd (fetched 2026-08-28T04:03:34.916511+00:00, sha 0ab2fa0b78ad)
  - homepage: http://www.philipotoole.com/building-a-distributed-key-value-store-using-raft/ (fetched 2026-08-29T12:49:33.826304+00:00, sha 1375e1cb85af)
  - site_page: https://philipotoole.com/about (fetched 2026-08-29T12:49:33.835558+00:00, sha 52df0984a92a)
- Data as of 2026-08-30T08:39:29.467469+00:00.