The stable version can be used in two ways: as a system/user library through pip, or from a docker image.

Using docker is recommended because the image is self-contained, reproducible and isolated from the system, which means:

  • It can be downloaded and run with just one simple command
  • All dependencies are included
  • It is OS-independent (MacOS, Windows, GNU/Linux)
  • Several versions may coexist in the same machine without additional virtual environments

Additionally, you may create your own docker image with your custom plugins, ready to be used by others.

Through PIP

pip install senpy

# Or with --user if you get permission errors:

pip install --user senpy

Each version is automatically tested on GNU/Linux, macOS and Windows 10. If you have trouble with the installation, please file an issue on GitHub.

Docker Image

The base image of senpy comes with some built-in plugins that you can use:

docker run -ti -p 5000:5000 gsiupm/senpy --host

To use your custom plugins, you can add volume to the container:

docker run -ti -p 5000:5000 -v <PATH OF PLUGINS>:/plugins gsiupm/senpy --host --plugins -f /plugins


If you are using the docker approach regularly, it is advisable to use a script or an alias to simplify your executions:

alias senpy='docker run --rm -ti -p 5000:5000 -v $PWD:/senpy-plugins gsiupm/senpy'

Now, you may run senpy from any folder in your computer like so:

senpy --version