Skip to main content

PyCOMPSs cli

Project description


The PyCOMPSs CLI (pycompss) provides a standalone tool to use PyCOMPSs interactively within docker environments, local machines and remote clusters. This tool has been implemented on top of PyCOMPSs programming model, and it is being developed by the Workflows and Distributed Computing group of the Barcelona Supercomputing Center.



There are two ways in which you can get started with PyCOMPSs. You can perform a local installation by installing the pycompss package, or you can use it through our ready-to-use docker image thorugh this pycompss-cli tool.


python3 -m pip install pycompss-cli

This should add the pycompss-cli executables (pycompss, compss and dislib) to your path. They can be used indiferently.

Warning: The user executable path may not be automatically exported into the PATH environment variable. So, take this into account if installed with the --user flag, since the pycompss|compss command will be unreachable until the path is exported into PATH.

Dependencies (Optional)

For creating docker environments pycompss-cli currently requires:

  • docker >= 17.12.0-ce

  1. Install docker

    • pycompss-cli requires docker 17.12.0-ce or greater.

    1. Follow these instructions

      Be aware that for some distros the docker package has been renamed from docker to docker-ce. Make sure you install the new package.

    2. Add user to docker group to run pycompss as a non-root user.

    3. Check that docker is correctly installed

      docker --version
      docker ps # this should be empty as no docker processes are yet running.
    4. Install docker-py

      python3 -m pip install docker


For detailed instructions and examples of usage please visit official documentation.


Apache License Version 2.0

Workflows and Distributed Computing

Department of Computer Science

Barcelona Supercomputing Center (

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

pycompss-cli-3.3.2.tar.gz (49.7 kB view hashes)

Uploaded source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page