1. Install git, postgresql version >= 9.4, virtualenv and Node.js version >= 6 in your computer, if you don't have it already. Please check that the python version you are using for the project is 2.7.x. If you are having trouble with postgresql on Windows check this link postgresqlhelp.
2. Get the source code on your machine via git

   git clone [email protected]:Cloud-CV/CloudCV.git cloudcv
   

   If you have not added ssh keys to your GitHub account then get the source code by running the following command

   git clone https://github.com/Cloud-CV/CloudCV.git cloudcv
   

3. Create a python virtual environment and install python dependencies.

   cd cloudcv
   virtualenv venv
   source venv/bin/activate  # run this command everytime before working on project
   pip install -r requirements/dev.txt
   

4. Rename settings/dev/settings.sample.py as settings/dev/settings.py and change credentials in settings/dev/settings.py

   cp settings/dev/settings.sample.py settings/dev/settings.py
   

   Use your postgres username and password for fields USER and PASSWORD in settings/dev/settings.py file.
5. Create an empty postgres database and run database migration.

   sudo -i -u (username)
   createdb cloudcv
   python manage.py migrate --settings=settings.dev.settings
   

6. That's it. Now you can run development server at http://127.0.0.1:8000 (for serving backend)

   python manage.py runserver --settings=settings.dev.settings
   

7. Open a new terminal window with node(>=6) and ruby(gem) install on your machine and type

   cd frontend
   sudo npm install -g yarn
   yarn install
   

   If you running npm install behind a proxy server, use

   npm config set proxy http://proxy:port
   

8. Now to connect to dev server at http://127.0.0.1:6003 (for serving frontend)

   yarn run dev
   

If you are interested in contributing to CloudCV, follow our contribution guidelines.