gitwtfhub

wtf is muduo?

chenshuo/muduo — explained in plain English

Analysis updated 2026-06-24

★ 16,087C++Audience · developerComplexity · 4/5LicenseSetup · moderate

TL;DR

A C++ multi-threaded network library for Linux based on the reactor pattern, used to build high-concurrency server software.

Mindmap

mindmap
  root((muduo))
    Inputs
      TCP connections
      Event callbacks
      Buffer reads
    Outputs
      Async responses
      Multi-thread dispatch
      Server processes
    Use Cases
      Build chat server
      Build HTTP backend
      Build RPC service
      Learn reactor pattern
    Tech Stack
      C Plus Plus
      Linux
      CMake
      Boost

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Build a high-concurrency chat server on Linux without writing epoll code by hand.

REASON 2

Implement a custom RPC backend using muduo's TcpServer and EventLoop.

REASON 3

Study the reactor pattern by reading a production-quality C++ codebase.

REASON 4

Prototype a low-latency game backend on a single Linux box.

What's in the stack?

C++LinuxCMakeBoost

How it stacks up

chenshuo/muduoustc-resource/ustc-coursewolfpld/tracy
Stars16,08716,11015,942
LanguageC++C++C++
Setup difficultymoderateeasyhard
Complexity4/51/54/5
Audiencedevelopergeneraldeveloper

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

How do you spin it up?

Difficulty · moderate Time to first run · 1h+

Linux-only, needs a modern C++ compiler, CMake, and Boost installed before building.

Free to use, modify, and redistribute under a permissive BSD-style license, keeping the copyright notice.

Wtf does this do

Muduo is a network library written in C++ for building fast, multi-threaded server applications on Linux. A network library handles the low-level plumbing of accepting connections, sending and receiving data, and managing many simultaneous clients, so developers can focus on their application logic instead of re-implementing these basics from scratch. It is built around the reactor pattern, a common architectural approach where a single thread waits for network events (like an incoming message) and then dispatches them to worker threads for processing. This makes it well-suited for server software that needs to handle many concurrent connections efficiently. Muduo is aimed at C++ developers building backend server software on Linux who need a reliable, well-tested networking foundation. The README notes requirements of Linux kernel 2.6.28 or newer and a modern C++ compiler.

Yoink these prompts

Prompt 1
Build muduo from source on Ubuntu 24.04 with CMake, list the apt packages I need and the build commands.
Prompt 2
Write a minimal muduo TcpServer in C++ that echoes whatever a client sends, listening on port 9000.
Prompt 3
Show how to use muduo's EventLoopThreadPool to scale a TCP server across 8 worker threads.
Prompt 4
Port a small Boost.Asio server to muduo and explain the main API differences.
Prompt 5
Profile a muduo-based service under 10k concurrent connections and find the bottleneck.

Frequently asked questions

wtf is muduo?

A C++ multi-threaded network library for Linux based on the reactor pattern, used to build high-concurrency server software.

What language is muduo written in?

Mainly C++. The stack also includes C++, Linux, CMake.

What license does muduo use?

Free to use, modify, and redistribute under a permissive BSD-style license, keeping the copyright notice.

How hard is muduo to set up?

Setup difficulty is rated moderate, with roughly 1h+ to a first successful run.

Who is muduo for?

Mainly developer.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.

Other repos in this lane