/EvalAI

EvalAI: A platform for hosting AI Challenges

Primary LanguagePython

EvalAI

Join the chat at https://gitter.im/Cloud-CV/EvalAI Build Status Coverage Status Requirements Status Code Health Code Climate

EvalAI is an open source web application that helps researchers, students and data-scientists to create, collaborate and participate in various AI challenges organized round the globe.

How to setup

Setting up EvalAI on your local machine is really easy. Follow this guide to setup your development machine.

  1. Install git, postgresql and virtualenv, in your computer, if you don't have it already. 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 https://github.com/Cloud-CV/EvalAI.git evalai
  3. Create a python virtual environment and install python dependencies.

    cd evalai
    virtualenv venv
    source venv/bin/activate  # run this command everytime before working on project
    pip install -r requirements/dev.txt
  4. Rename settings/dev.sample.py as dev.py and change credential in settings/dev.py

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

    Use your linux system username and password for fields USER and PASSWORD in dev.py file.

  5. Create an empty postgres database and run database migration.

    createdb evalai
    python manage.py migrate --settings=settings.dev
    
  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
    
  7. Open a new terminal window with node(6.9.2) and ruby(gem) install on your machine and type

    npm install
    bower install
    
  8. To build static files(development) type

    gulp dev
    
  9. That's it, Now to connect to dev server at http://127.0.0.1:8888 (for serving frontend)

    gulp connect
    
  10. To check for static files change run gulp watch task in new terminal window

    gulp watch
    

Contribution guidelines

If you are interested in contributing to EvalAI, follow your contribution guidelines.