Solving the Stable Marriage problem in Erlang

Whilst talking with an ex-colleague, a question came up on how to implement the Stable Marriage problem using a message passing approach. Naturally, I wanted to answer that question with Erlang!

Let’s first dissect the problem and decide what processes we need and how they need to interact with one another.

The stable marriage problem is commonly stated as:

Given n men and n women, where each person has ranked all members of the opposite sex with a unique number between 1 and n in order of preference, marry the men and women together such that there are no two people of opposite sex who would both rather have each other than their current partners. If there are no such people, all the marriages are “stable”. (It is assumed that the participants are binary gendered and that marriages are not same-sex).

From the problem description, we can see that we need:

  • a module for man
  • a module for woman
  • a module for orchestrating the experiment

In terms of interaction between the different modules, I imagined something along the line of the following:


The proposal communication needs to be synchronous* as the man cannot proceed until he gets an answer for his proposal. But all other communications can be asynchronous.

(* remember, a synchronous call in OTP-sense is not the same as a synchronous call in Java/C# where the calling thread is blocked.

In this case the communication still happens via asynchronous message passing, but the calling process asynchronously waits for a reply before moving on)

From here, the implementation itself is pretty straight forward.

And using the test data from Rosetta Code, you can have a module that sets up the test, which I’ve called stable_marriage here.

Compile and run the code gives the following output:


You can get the full source code for this solution on github.



Repo for solution

Rosetta Code test data

Enjoy what you’re reading? Subscribe to my newsletter and get more content on AWS and serverless technologies delivered straight to your inbox.

Yan Cui

I’m an AWS Serverless Hero and the author of Production-Ready Serverless. I have run production workload at scale in AWS for nearly 10 years and I have been an architect or principal engineer with a variety of industries ranging from banking, e-commerce, sports streaming to mobile gaming. I currently work as an independent consultant focused on AWS and serverless.

You can contact me via Email, Twitter and LinkedIn.

Hire me.

Check out my new course, Complete Guide to AWS Step Functions.

In this course, we’ll cover everything you need to know to use AWS Step Functions service effectively. Including basic concepts, HTTP and event triggers, activities, design patterns and best practices.

Get Your Copy