mpi-hs-binary: MPI bindings for Haskell

[ apache, distributed-computing, library, program ] [ Propose Tags ]

MPI (the Message Passinag Interface) is a widely used standard for distributed-memory programming on HPC (High Performance Computing) systems. MPI allows exchanging data (_messages_) between programs running in parallel. There are several high-quality open source MPI implementations (e.g. MPICH, MVAPICH, OpenMPI) as well as a variety of closed-source implementations. These libraries can typically make use of high-bandwidth low-latency communication hardware such as InfiniBand.

This library mpi-hs provides Haskell bindings for MPI. It is based on ideas taken from [haskell-mpi](https:/github.combjpop/haskell-mpi), [Boost.MPI](https:/www.boost.orgdoclibs1_64_0dochtml/mpi.html) for C++, and MPI for Python.

mpi-hs provides two API levels: A low-level API gives rather direct access to the actual MPI API, apart from certain "reasonable" mappings from C to Haskell (e.g. output arguments that are in C stored via a pointer are in Haskell regular return values). A high-level API simplifies exchanging arbitrary values that can be serialized.

Note that the automated builds on [Hackage]( will currently always fail since no system MPI library is present there. However, builds on [Stackage]( should succeed -- if not, there is an error in this package.

[Skip to Readme]
Versions [RSS] [faq],
Dependencies base (==4.*), binary, bytestring, monad-loops, mpi-hs (>=, mpi-hs-binary [details]
License Apache-2.0
Author Erik Schnetter <>
Maintainer Erik Schnetter <>
Category Distributed Computing
Home page
Bug tracker
Source repo head: git clone
Uploaded by eschnett at 2020-04-18T21:52:47Z
Distributions LTSHaskell:, NixOS:, Stackage:
Executables version, example2, example1
Downloads 254 total (11 in the last 30 days)
Rating (no votes yet) [estimated by Bayesian average]
Your Rating
  • λ
  • λ
  • λ
Status Hackage Matrix CI
Docs uploaded by user
Build status unknown [no reports yet]




Maintainer's Corner

For package maintainers and hackage trustees


Readme for mpi-hs-binary-

[back to package description]


MPI bindings for Haskell


This is a companion package to mpi-hs. Read the documentation there.

This package mpi-hs-binary provides a high-level interface based on Data.Binary in the binary package. This is a separate package to reduce dependencies for mpi-hs. Note that mpi-hs has a similar high-level interface based on Data.Storable already built in.

Running the tests

There is one test case provided in tests:

stack build --test --no-run-tests
mpiexec -n 3 stack exec -- $(stack path --dist-dir)/build/mpi-test-binary/mpi-test-binary