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

The docker image is the recommended way because it is self-contained and isolated from the system, which means:

  • Downloading and using it is just one 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

Docker Image

The base image of senpy comes with some builtin plugins that you can use:

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

To add your custom plugins, you can use a docker volume:

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

There is a Senpy image for python 2, too:

docker run -ti -p 5000:5000 gsiupm/senpy:python2.7 --host


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