mirror of https://github.com/gsi-upm/senpy
You cannot select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
71 lines
1.7 KiB
ReStructuredText
71 lines
1.7 KiB
ReStructuredText
Installation
|
|
------------
|
|
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
|
|
***********
|
|
|
|
.. code:: bash
|
|
|
|
pip install --user senpy
|
|
|
|
|
|
Alternatively, you can use the development version:
|
|
|
|
.. code:: bash
|
|
|
|
git clone git@github.com:gsi-upm/senpy
|
|
cd senpy
|
|
pip install --user .
|
|
|
|
If you want to install senpy globally, use sudo instead of the ``--user`` flag.
|
|
|
|
Docker Image
|
|
************
|
|
The base image of senpy comes with some builtin plugins that you can use:
|
|
|
|
.. code:: bash
|
|
|
|
docker run -ti -p 5000:5000 gsiupm/senpy --host 0.0.0.0
|
|
|
|
To add your custom plugins, you can use a docker volume:
|
|
|
|
.. code:: bash
|
|
|
|
docker run -ti -p 5000:5000 -v <PATH OF PLUGINS>:/plugins gsiupm/senpy --host 0.0.0.0 --plugins -f /plugins
|
|
|
|
|
|
|
|
There is a Senpy image for **python 2**, too:
|
|
|
|
.. code:: bash
|
|
|
|
docker run -ti -p 5000:5000 gsiupm/senpy:python2.7 --host 0.0.0.0
|
|
|
|
|
|
Alias
|
|
.....
|
|
|
|
If you are using the docker approach regularly, it is advisable to use a script or an alias to simplify your executions:
|
|
|
|
.. code:: bash
|
|
|
|
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:
|
|
|
|
.. code:: bash
|
|
|
|
senpy --version
|