An open API service indexing awesome lists of open source software.

https://github.com/faasm/faasm

High-performance stateful serverless runtime based on WebAssembly
https://github.com/faasm/faasm

cpp faas kubernetes mpi openmp serverless wasi wasm webassembly

Last synced: 18 days ago
JSON representation

High-performance stateful serverless runtime based on WebAssembly

Awesome Lists containing this project

README

          



# Faasm [![Tests](https://github.com/faasm/faasm/workflows/Tests/badge.svg?branch=main)](https://github.com/faasm/faasm/actions) [![License](https://img.shields.io/github/license/faasm/faasm.svg)](https://github.com/faasm/faasm/blob/main/LICENSE.md) [![Release](https://img.shields.io/github/release/faasm/faasm.svg)](https://github.com/faasm/faasm/releases/) [![Contributors](https://img.shields.io/github/contributors/faasm/faasm.svg)](https://github.com/faasm/faasm/graphs/contributors/) [![codecov](https://codecov.io/gh/faasm/faasm/branch/main/graph/badge.svg?token=F7HBQ84OSD)](https://codecov.io/gh/faasm/faasm)

Faasm is a high-performance stateful serverless runtime.

Faasm provides multi-tenant isolation, yet allows functions to share regions of
memory. These shared memory regions give low-latency concurrent access to data,
and are synchronised globally to support large-scale parallelism across multiple
hosts.

Faasm combines software fault isolation from WebAssembly with standard Linux
tooling, to provide security and resource isolation at low cost. Faasm runs
functions side-by-side as threads of a single runtime process, with low
overheads and fast boot times.

Faasm defines a custom host interface that extends [WASI](https://wasi.dev/) to
include function inputs and outputs, chaining functions, managing state,
accessing the distributed filesystem, dynamic linking, pthreads, OpenMP and MPI.

In our [paper from USENIX ATC 20](
https://www.usenix.org/conference/atc20/presentation/shillaker) we present
the initial Faasm design and evaluate it in the context of stateful serverless
functions.

In our [paper from USENIX NSDI'25, GRANNY](
https://www.usenix.org/conference/nsdi25/presentation/segarra), we present the
design of the OpenMP and MPI runtimes, as well as new dynamic resource
management policies, all implemented in the [faabric](
https://github.com/faasm/faabric) library.

Please see the [full documentation](https://faasm.readthedocs.io/en/latest/) for
more details on the code and architecture.

## Quick start

Update submodules and activate the virtual environment:

```bash
git submodule update --init --recursive
source ./bin/workon.sh
```

Start a Faasm cluster locally using `docker compose`:

```bash
faasmctl deploy.compose
```

To compile, upload and invoke a C++ function using this local cluster you can
use the [faasm/cpp](https://github.com/faasm/cpp) container:

```bash
faasmctl cli.cpp

# Compile the demo function
inv func demo hello

# Upload the demo "hello" function
inv func.upload demo hello

# Invoke the function
inv func.invoke demo hello
```

For more information on next steps you can look at the [getting started
docs](https://faasm.readthedocs.io/en/latest/source/getting_started.html)

## Acknowledgements

This project has received funding from the European Union's Horizon 2020
research and innovation programme under grant agreements No 825184 (CloudButton),
No 101086248 (CloudStars), and No 101092646 (CloudSKin), the UK Engineering and
Physical Sciences Research Council (EPSRC) award 1973141, and a gift from Intel
Corporation under the TFaaS project.