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 a version of the Linux or OS X operating systems.

1. 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.
2. Visit the GraphSpace directory: cd GraphSpace
3. Create a virtual environment for the project: virtualenv venv
4. Start using the virtual environment: source venv/bin/activate
5. In /graphspace/settings/local.py file, change the postgres user credentials:

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

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