jepsen-io/maelstrom resource

Health v2 · maintenance only

Adoption not part of the score

3668 stars · 214 forks observed · 2026-08-28

What it is AI-extracted, prompt v1, taxonomy v1, 2026-08-29, confidence not recorded

Maelstrom is a workbench for learning distributed systems by writing toy implementations, built on the Jepsen testing library. It provides standardized workloads over a simple JSON STDIN/STDOUT protocol, a simulated network with latency and partition faults, and checkers that verify safety properties up to strict serializability.

Use cases

• learn distributed systems by implementing toy servers
• test a broadcast or gossip protocol implementation
• verify a transactional key-value store for consistency anomalies
• simulate network partitions and message loss in a cluster
• practice building Raft or Paxos replicas
• run a distributed systems workshop exercise

When to choose

• you want hands-on practice implementing distributed algorithms in any language
• you need fault injection and linearizability/serializability checking for a toy system
• you're following a distributed systems course or self-study curriculum

When to avoid

• you need to test a real production distributed system rather than a toy
• you want a framework for building deployable distributed software
• you need non-simulated network testing on real infrastructure

Facets

learning-resource · maturity active

testing e2e-testing developer-tools microservices education testing developer-tools jvm cli jepsen distributed-systems fault-injection consistency-checking workshop json-protocol network-simulation linux macos

Member repositories

For agents

markdown · JSON · MCP: product_card(name="jepsen-io/maelstrom")