Maelstrom

A Devbox for running Maelstrom Tests. Maelstrom is a testing library for toy distributed systems built by @aphyr, useful for learning the basics and principals of building distributed systems

You should also check out the Fly.io Distributed Systems Challenge

Prerequisites

If you don't already have Devbox, you can install it by running the following command:

curl -s https://get.jetify.com/install.sh | bash

You can skip this step if you're running on devbox.sh

Usage

1. Install Maelstrom by running devbox run install. This should install Maelstrom 0.2.2 in a maelstrom subdirectory

2. cd into the maelstrom directory and run ./maelstrom to verify everything is working

3. You can now follow the docs and run the tests in the Maelstrom Docs + Readme. You can use glow from the command line to browse the docs.

This shell includes Ruby 3.10 for running the Ruby Demos. To run demos in other languages, install the appropriate runtimes using devbox add. For example, to run the Python demos, use devbox add python310.