Thanks for giving pls a try. pls, being a Python package, needs Python 3.8 or newer. There are two approaches to installing pls, using either pipx (which is a great tool for managing Python binaries) or pip (which comes pre-installed with Python).


To install pls, you need to have the following software installed.

  • Python 3.8
  • pip or pipx (your preferred mode of installation)

Some features need additional dependencies.

With pipx

pipxopen in new window is a fine way to install executable Python packages globally while still isolating them in virtual environments. This allows for clean upgrades and uninstalls. You can learn more about pipx from their documentation.

For new installs, we recommend using this approach.


To install pls using pipx you need to first install pipx! Read the pipx documentation to learn howopen in new window.


$ pipx install pls


$ pipx upgrade pls


$ pipx uninstall pls

With pip

This is the simplest way to install and use pls. It does have one major drawback: it installs lots of packages to the global namespace that will be left behind after pls is uninstalled.

We recommend giving pipx a try.


To install using pip, you need to have pip. If you have Python installed, it is very likely you also have pip installed too.


$ pip install --user pls


$ pip install --user --upgrade pls


$ pip uninstall pls


To check if pls is installed and discoverable in your path, run the following command. If the version number you see is the same as the latest version on PyPIopen in new window, you're all set!

$ pls --version
$ pls -v
pls x.y.z