Installing GraphSpace on Windows machines

GraphSpace

GraphSpace is running at http://graphspace.org

GraphSpace has three dummy users:

1. Username: user1@example.com Password: user1
2. Username: user2@example.com Password: user2
3. Username: user3@example.com Password: user3

Requirements

Please install the following packages or make sure they are already installed.

1. Python v2.7.10
2. PostgreSQL
3. virtualenv
4. Node.js
5. bower
6. ElasticSearch

Running GraphSpace locally

In order to run GraphSpace, please install postgreSQL and both the Python runtime and development environments. We have tested GraphSpace with Python v2.7.10 and postgreSQL v9.6.2. GraphSpace does not support Python v3. GraphSpace performs best on either Mozilla Firefox or Google Chrome browsers. The following steps describe how to install Python packages required by GraphSpace, download the GraphSpace code, and set up and start the server. The following instructions should apply to computers running Windows Operating System. The current build instructions has been tested on Windows 10.

1. Make sure ElasticSearch service is running : Running ElasticSearch as a service on Windows
2. Download the GraphSpace code by running git clone https://github.com/Murali-group/GraphSpace.git or by downloading the latest release: https://github.com/Murali-group/GraphSpace/releases.
3. In /graphspace/settings/local.py file, change the postgres user credentials:

DATABASES = {
     'default': {
         'ENGINE': 'django.db.backends.postgresql_psycopg2',
         'NAME': <database name>,
         'USER': <user name>,
         'PASSWORD': <password (if any)>,
         'HOST': 'localhost',
         'PORT': '5432'
     }
 }

4. Visit the GraphSpace directory: cd GraphSpace
5. Create a virtual environment for the project: virtualenv venv
6. Start using the virtual environment by typing the following command in cmd Prompt: source venv/bin/activate
7. Run the following commands in the Command prompt (cmd) or the Windows PowerShell:

pip install django==1.9.7`
pip install urllib3
pip install psycopg2
pip install networkx
Pip install bcrypt
pip install django-analytical
pip install python-dateutil
python setup.py install
bower install
python manage.py migrate --settings=graphspace.settings.local

8. Finally, start the GraphSpace server: python manage.py runserver --settings=graphspace.settings.local
9. Visit http://localhost:8080 and enjoy using GraphSpace!

Documentation

GraphSpace has extensive documentation on the user interface, the REST API and a Python package for programmatic interaction.

Contributing

Feel free to fork and send us pull requests. Here are the guidelines for contribution in GraphSpace.