what is phxpaxos fr?

tencent/phxpaxos — explained in plain English

Analysis updated 2026-07-17 · repo last pushed 2023-12-04

★ 3,370C++Audience · developerComplexity · 5/5DormantSetup · hard

vibe map

mindmap
  root((phxpaxos))
    Inputs
      Proposed operations
      State machine rules
      Multiple servers
    Outputs
      Ordered consensus
      Durable writes
      Consistent replicas
    Use Cases
      Build a distributed KV store
      Run a configuration server
      Master-election system
    Tech Stack
      C++
      Linux
      Paxos protocol
    Audience
      Backend developers
      Distributed systems engineers

mindmap root((phxpaxos)) Inputs Proposed operations State machine rules Multiple servers Outputs Ordered consensus Durable writes Consistent replicas Use Cases Build a distributed KV store Run a configuration server Master-election system Tech Stack C++ Linux Paxos protocol Audience Backend developers Distributed systems engineers

what do people make with this?

VIBE 1

Build a distributed key-value store where every server ends up with identical data via the Paxos protocol.

VIBE 2

Run a configuration server that stays consistent even if some machines crash or the network is delayed.

VIBE 3

Build a master-election system that reliably agrees on which server is the active leader.

VIBE 4

Wrap an existing single-server service, like an echo service, with PhxPaxos to make it fault-tolerant.

what's the stack?

C++LinuxPaxos

how it stacks up fr

	tencent/phxpaxos	odriverobotics/odrive	nerdlang/nerd
Stars	3,370	3,614	3,616
Language	C++	C++	C++
Last pushed	2023-12-04	—	—
Maintenance	Dormant	—	—
Setup difficulty	hard	hard	moderate
Complexity	5/5	4/5	4/5
Audience	developer	developer	developer

Figures from each repo's GitHub metadata at analysis time.

how do i run it?

Difficulty · hard time til it works · 1day+

Requires writing a custom state machine and integrating the consensus library into your existing service, C++ on Linux only.

License is not stated in the available content.

prompts (copy fr)

prompt 1

Using PhxPaxos, show me how to wrap a simple echo service so it runs reliably across three servers with consensus.

prompt 2

Write a PhxPaxos state machine for a key-value store that applies 'set key to value' commands in the same order on every replica.

prompt 3

Explain how PhxPaxos guarantees durability and ordering when I propose a financial transaction to the cluster.

prompt 4

Using PhxPaxos's configuration-store example as a reference, help me design a distributed config server for my service.

prompt 5

Walk me through integrating PhxPaxos into an existing C++ service so it survives a single machine going down.

Frequently asked questions