https://github.com/HumanDynamics/openPDS

https://github.com/HumanDynamics/openPDS

Last synced: 3 months ago
JSON representation

• Host: GitHub
• URL: https://github.com/HumanDynamics/openPDS
• Owner: HumanDynamics
• License: mit
• Created: 2013-04-23T09:35:55.000Z (over 11 years ago)
• Default Branch: master
• Last Pushed: 2019-04-29T13:34:55.000Z (over 5 years ago)
• Last Synced: 2024-07-15T14:40:52.364Z (5 months ago)
• Language: Python
• Homepage: openpds.media.mit.edu
• Size: 12.7 MB
• Stars: 110
• Watchers: 29
• Forks: 33
• Open Issues: 12
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
openPDS - Personal Data Store / Server

======================================

The personal data store component of [openPDS](http://openpds.media.mit.edu/) handles storage of raw personal data, provides endpoints for writing such data via connectors, a computation engine to perform analysis on the raw data, as well as storage and REST endpoints for results of such analysis (answers to questions, in openPDS lingo).

__Please note__: openPDS requires a separate registry server for account management and to act as an OAuth 2.0 provider. This can be found at https://github.com/HumanDynamics/openPDS-RegistryServer. If you run your own registry server, the domain for your registry server must be provided to the openPDS setup script.

__Contributors__: The dev branch is for ongoing development. Please submit pull requests to this brach.

## Getting started with openPDS

(You must have python pip, virtualenv, and mongodb server installed on your machine)

```sh

# install python and database dependencies

apt-get install python pip

apt-get install python-virtualenv

apt-get install postgresql postgresql-contrib

apt-get install mongodb mongodb-server

apt-get install python-dev libpq-dev

service mongodb start

```

## Creating a [python virtual environment](http://docs.python-guide.org/en/latest/dev/virtualenvs/) for openPDS

You must clone the repo into the virtualenv directory for `setup.py` to work:

```sh

# create the virtual environment

virtualenv pdsEnv

cd pdsEnv

source bin/activate

# get the latest openPDS code

git clone https://github.com/HumanDynamics/openPDS.git

cd openPDS

# install openPDS and its requirements

pip install -r requirements.txt

# set up and run your local openPDS

python start.py

python manage.py syncdb

python manage.py runserver 0.0.0.0:8002 (for access to local VM)

```

The above steps will start openPDS with default configuration settings on port `8002` of the loopback interface (local access only) on your machine. The openPDS setup script generates a wsgi file that can be used to run openPDS with other web server software, such as Apache.