Requirements
Minimal Requirements
Python >= 3.10
Linux, MacOS, or Windows.
Optional Requirements
The CLI supports various COMPSs installed environments. Depending on the environment type, additional requirements may apply.
Local environments
Linux or MacOS
Caution
⚠️ Windows users: COMPSs does not provide native support for Windows. Please use WSL (Windows Subsystem for Linux) to enable local environment usage.
Remote environments (HPC)
Internet connectivity
Access to the remote machine
Dockerized environments
To run and deploy Docker-based environments, the following installations are required:
docker package for Python
Linux
Install Docker (skip this step if already installed):
- Suggested installation instructions:
Note: In some distributions, the Docker package has been renamed from
dockertodocker-ce. Ensure you install the correct package.Configure permissions: Add the user to the docker group to run containers as a non-root user:
Verify installation:
$ docker --version $ docker ps # this should be empty as no docker processes are yet running.Install the Python docker library:
$ python3 -m pip install dockerTip
Some Linux distributions do not include the
$HOME/.local/binfolder in thePATHenvironment variable, preventing access to thepycompss-clicommands (and any other Python packages installed in the user HOME). If thepycompss,compss, ordislibcommands are not recognized after installation, add the following line to your.bashrcand refresh your current session:$ export PATH=${HOME}/.local/bin:${PATH}
MacOS
Install Docker (skip this step if already installed):
- Suggested installation instructions:
Alternatively, use Homebrew.
Configure permissions: Add the user to the docker group to run containers as a non-root user:
Verify installation:
Install the Python docker library:
Tip
If the
pycompss,compss,dislib, orqdislibcommands are not recognized after installation, you may need to include the following line in your.bashrcor.zshrcand refresh your current session:$ export PATH=${HOME}/.local/bin:${PATH}
Windows
Install Docker (skip this step if already installed):
Suggested installation instructions: - Docker for Windows.
Verify installation:
$ docker --version $ docker ps # this should be empty as no docker processes are yet running.Install the Python docker library:
$ python3 -m pip install docker
UNICORE environments
Installing pyunicore for Python is required for running and deploying UNICORE-type environments.
$ python3 -m pip install pyunicore