Lithops is a Python multi-cloud distributed computing framework. It allows you to run unmodified local python code at massive scale in the main serverless computing platforms. Lithops delivers the user’s code into the cloud without requiring knowledge of how it is deployed and run. Moreover, its multicloud-agnostic architecture ensures portability across cloud providers.

Lithops is specially suited for highly-parallel programs with little or no need for communication between processes, but it also supports parallel applications that need to share state among processes. Examples of applications that run with Lithops include Monte Carlo simulations, deep learning and machine learning processes, metabolomics computations, and geospatial analytics, to name a few.


  1. Install Lithops from the PyPi repository:

    pip install lithops
  2. Execute a Hello World test function:

    lithops test


Lithops provides an extensible backend architecture (compute, storage) that is designed to work with different Cloud providers and on-premise backends. In this sense, you can code in python and run it unmodified in IBM Cloud, AWS, Azure, Google Cloud, Aliyun and Kubernetes or OpenShift.

Follow these instructions to configure your compute and storage backends

Multicloud Lithops

High-level API

Lithops is shipped with 2 different high-level Compute APIs, and 2 high-level Storage APIs

Futures API

Multiprocessing API

from lithops import FunctionExecutor

def hello(name):
    return 'Hello {}!'.format(name)

with FunctionExecutor() as fexec:
    fut = fexec.call_async(hello, 'World')
from lithops.multiprocessing import Pool

def double(i):
    return i * 2

with Pool() as pool:
    result =, [1, 2, 3, 4])

Storage API

Storage OS API

from lithops import Storage

if __name__ == "__main__":
    st = Storage()
                  body='Hello World')

from import os

if __name__ == "__main__":
    filepath = 'bar/foo.txt'
    with, 'w') as f:
        f.write('Hello world!')

    dirname = os.path.dirname(filepath)

You can find more usage examples in the examples folder.

Execution Modes

Lithops is shipped with 3 different modes of execution. The execution mode allows you to decide where and how the functions are executed.

Localhost Mode

Serverless Mode

Standalone Mode

This mode allows you to run functions in your local machine, by using processes. This is the default mode of execution if no configuration is provided.

This mode allows you to run functions by using publicly accessible Serverless compute services, such as IBM Cloud Functions, Amazon Lambda or Google Cloud Functions, among others. In this mode of execution, each function invocation equals to a parallel task running in the cloud in an isolated environment.

This mode allows to run functions by using one or multiple Virtual machines (VM), either in a private cluster or in the cloud. In each VM, functions run using parallel processes like in the Localhost mode.


For documentation on using Lithops, see latest release documentation or current github docs.

If you are interested in contributing, see

Additional resources

Blogs and Talks




This project has received funding from the European Union's Horizon 2020 research and innovation programme under grant agreement No 825184.