Installation
You can either install the Slicer Package Manager natively on your machine or inside it’s own virtual environment.
Virtual environment
While not strictly required, it is recommended to install the Slicer Package Manager and Girder
within its own virtual environment to isolate its dependencies from other python packages.
To generate a new virtual environment, first install/update the virtualenv
and pip
packages:
$ sudo pip install -U virtualenv pip
Now create a virtual environment using the virtualenv command. You can place the virtual environment directory wherever you want, but
it should not be moved. The following command will generate a new directory called
slicer_package_manager_env
in your home directory:
$ virtualenv ~/slicer_package_manager_env
Then to enter in the virtual environment, use the command:
$ . ~/slicer_package_manager_env/bin/activate
Note
The (slicer_package_manager_env)
prepended to your prompt indicates you have entered the
virtual environment.
Install from Git
To easily develop the Slicer Package Manager, you will need to use some of Girder commands. So let’s start by installing Girder:
$ git clone https://github.com/girder/girder.git
$ cd girder
$ pip install -e .
Then, let’s install the Slicer Package Manager server plugin:
$ git clone https://github.com/girder/slicer_package_manager
$ cd slicer_package_manager
$ pip install -e .[test]
This will provide you all the package needed to run the development environment. Then install the front-end web client development dependencies:
$ girder build --dev
Run
To run the server, first make sure the Mongo daemon is running. To manually start it, run:
$ mongod &
Then to run Girder itself, just use the following command:
$ girder-server --dev
The application should be accessible on http://localhost:8080/ in your web browser.