Community Framework for Enabling Scientific Workflow Research and Education

distributed-systems, hpc, reproducible-research, scheduling-simulator, scientific-workflows, simulation, workflow, workflow-generator, workflow-management-system, workflow-simulator
pip install wfcommons==0.5


Build PyPI version License: LGPL v3 CodeFactor Documentation Status

A Community Framework for Enabling Scientific Workflow Research and Development

This Python package provides a collection of tools for:

  • Analyzing traces of actual workflow executions;
  • Producing recipes structures for creating workflow recipes for workflow generation; and
  • Generating synthetic realistic workflow traces.


WorkflowHub is available on PyPI. WorkflowHub requires Python3.6+ and has been tested on Linux and macOS.



WorkflowHub uses pygraphviz and thus needs the graphviz package installed (version 2.16 or later). You can install graphviz easily on Linux with your favorite package manager, for example for Debian-based distributions:

sudo apt-get install graphviz libgraphviz-dev

and for RedHat-based distributions:

sudo yum install python-devel graphviz-devel

On macOS you can use brew package manager:

brew install graphviz

Installation using pip

While pip can be used to install WorkflowHub, we suggest the following approach for reliable installation when many Python environments are available:

$ python3 -m pip install workflowhub

Retrieving the latest unstable version

If you want to use the latest WorkflowHub unstable version, that will contain brand new features (but also contain bugs as the stabilization work is still underway), you may consider retrieving the latest unstable version.

Cloning from WorkflowHub's GitHub repository:

$ git clone
$ cd workflowhub
$ pip install .

Get in Touch

The main channel to reach the WorkflowHub team is via the support email:

Bug Report / Feature Request: our preferred channel to report a bug or request a feature is via
WorkflowHub's Github Issues Track.

Citing WorkflowHub

When citing WRENCH, please use the following paper. You should also actually read that paper, as it provides a recent and general overview on the framework.

  title = {WorkflowHub: Community Framework for Enabling Scientific Workflow Research and Development},
  author = {Ferreira da Silva, Rafael and Pottier, Lo\"ic and Coleman, Tain\~a and Deelman, Ewa and Casanova, Henri},
  booktitle = {2020 IEEE/ACM Workflows in Support of Large-Scale Science (WORKS)},
  year = {2020},
  pages = {49--56},
  doi = {10.1109/WORKS51914.2020.00012}