Python JavaScript HTML CSS Shell
Clone or download
Permalink
Failed to load latest commit information.
.github Docs: Fix broken hyperlink in Pull Request Template (#1465) Jan 14, 2018
apps Challenges: Add migration file for unique random name of challenge lo… Jul 14, 2018
docker Fix #1698: Update dev installation instructions (#1717) Jun 27, 2018
docs Add evalai-starters in challenge creation docs (#1676) Jun 3, 2018
evalai Update feature to send emails to evalai users using amazon ses (#1624) Apr 5, 2018
examples/example1 Fix #1641: Add tests for challenge creation using zip file (#1677) May 14, 2018
frontend Challenges: Update submission count API endpoint (#1744) Jul 12, 2018
middleware Adding datadog middleware for metrics (#459) Jan 15, 2017
requirements Fix #1735: Update django to version 1.11(#1737) Jul 3, 2018
scripts Submission worker: Allow submissions from challenge hosts to be evalu… Jun 4, 2018
settings Settings: Allow all hostnames to request files in dev env (#1743) Jul 9, 2018
static S3 storage and RDS configurations added Oct 21, 2016
tests Challenges: Update submission count API endpoint (#1744) Jul 12, 2018
.coveragerc Settings: Update django project settings (#1610) Mar 30, 2018
.coveralls.yml Fix: Coveralls issue reloved (#163) Nov 28, 2016
.dockerignore Docker: Improve docker configuration for Dev environment (#1667) Apr 25, 2018
.eslintrc Frontend: Allow console debug statement in development (#983) Jun 1, 2017
.gitignore Minor docker setup improvements (#1689) Jun 1, 2018
.landscape.yml Coda Quality: Added pylint configuration and modified landscape confi… Jan 11, 2017
.pylintrc Coda Quality: Added pylint configuration and modified landscape confi… Jan 11, 2017
.travis.yml Travis: Add Python 3.6 in allow_failures mode to Travis CI (#1331) Oct 30, 2017
CODE_OF_CONDUCT.md Docs: Add Code of Conduct (#865) Mar 23, 2017
LICENSE Fix #1022: Change license from GPL to BSD (#1023) May 29, 2017
README.md Fix #1698: Update dev installation instructions (#1717) Jun 27, 2018
bower.json Upgrade(Gulp): Version bump 3.9.1 -> 4.0.0 (#1697) Jun 16, 2018
docker-compose.yml Docker: Improve docker configuration for Dev environment (#1667) Apr 25, 2018
gulpfile.js Upgrade(Gulp): Version bump 3.9.1 -> 4.0.0 (#1697) Jun 16, 2018
karma.conf.js Frontend: Add unit tests for auth controller (#1468) Feb 10, 2018
manage.py Settings: Update django project settings (#1610) Mar 30, 2018
package.json Upgrade(Gulp): Version bump 3.9.1 -> 4.0.0 (#1697) Jun 16, 2018
pytest.ini Fix: Coveralls issue reloved (#163) Nov 28, 2016
setup.cfg Coda Quality: Added pylint configuration and modified landscape confi… Jan 11, 2017

README.md


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

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.

In recent years, it has become increasingly difficult to compare an algorithm solving a given task with other existing approaches. These comparisons suffer from minor differences in algorithm implementation, use of non-standard dataset splits and different evaluation metrics. By providing a central leaderboard and submission interface, we make it easier for researchers to reproduce the results mentioned in the paper and perform reliable & accurate quantitative analysis. By providing swift and robust backends based on map-reduce frameworks that speed up evaluation on the fly, EvalAI aims to make it easier for researchers to reproduce results from technical papers and perform reliable and accurate analyses.

A question we’re often asked is: Doesn’t Kaggle already do this? The central differences are:

  • Custom Evaluation Protocols and Phases: We have designed versatile backend framework that can support user-defined evaluation metrics, various evaluation phases, private and public leaderboard.

  • Faster Evaluation: The backend evaluation pipeline is engineered so that submissions can be evaluated parallelly using multiple cores on multiple machines via mapreduce frameworks offering a significant performance boost over similar web AI-challenge platforms.

  • Portability: Since the platform is open-source, users have the freedom to host challenges on their own private servers rather than having to explicitly depend on Cloud Services such as AWS, Azure, etc.

  • Easy Hosting: Hosting a challenge is streamlined. One can create the challenge on EvalAI using the intuitive UI (work-in-progress) or using zip configuration file.

  • Centralized Leaderboard: Challenge Organizers whether host their challenge on EvalAI or forked version of EvalAI, they can send the results to main EvalAI server. This helps to build a centralized platform to keep track of different challenges.

Goal

Our ultimate goal is to build a centralized platform to host, participate and collaborate in AI challenges organized around the globe and we hope to help in benchmarking progress in AI.

Performance comparison

Some background: Last year, the Visual Question Answering Challenge (VQA) 2016 was hosted on some other platform, and on average evaluation would take ~10 minutes. EvalAI hosted this year's VQA Challenge 2017. This year, the dataset for the VQA Challenge 2017 is twice as large. Despite this, we’ve found that our parallelized backend only takes ~130 seconds to evaluate on the whole test set VQA 2.0 dataset.

Installation Instructions

Setting up EvalAI on your local machine is really easy. You can setup EvalAI using two methods:

Using Docker

You can also use Docker Compose to run all the components of EvalAI together. The steps are:

  1. Get the source code on to your machine via git.

    git clone https://github.com/Cloud-CV/EvalAI.git evalai && cd evalai

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

  2. Build and run the Docker containers. This might take a while. You should be able to access EvalAI at localhost:8888.

    docker-compose up --build
    

Using Virtual Environment

  1. Install python 2.7.10 or above, git, postgresql version >= 10.1, RabbitMQ 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. Create an empty postgres database.

    sudo -i -u (username)
    createdb evalai
    
  5. Change Postgresql credentials in settings/dev.py and run migrations

    Use your postgres username and password for fields USER and PASSWORD in dev.py file. After changing credentials, run migrations using the following command:

    python manage.py migrate --settings=settings.dev
    
  6. Seed the database with some fake data to work with.

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

    This command also creates a superuser(admin), a host user and a participant user with following credentials.

    SUPERUSER- username: admin password: password
    HOST USER- username: host password: password
    PARTICIPANT USER- username: participant password: password

  7. 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
    
  8. Please make sure that node(>=7.x.x), npm(>=5.x.x) and bower(>=1.8.x) are installed globally on your machine.

    Install npm and bower dependencies by running

    npm install
    bower install
    

    If you running npm install behind a proxy server, use

    npm config set proxy http://proxy:port
    
  9. Now to connect to dev server at http://127.0.0.1:8888 (for serving frontend)

    gulp dev:runserver
    
  10. That's it, Open web browser and hit the url http://127.0.0.1:8888.

  11. (Optional) If you want to see the whole game into play, then start the RabbitMQ worker in a new terminal window using the following command that consumes the submissions done for every challenge:

    python scripts/workers/submission_worker.py
    

The Team

EvalAI is currently maintained by Deshraj Yadav, Akash Jain, Taranjeet Singh, Shiv Baran Singh and Rishabh Jain. A non-exhaustive list of other major contributors includes: Harsh Agarwal, Prithvijit Chattopadhyay, Devi Parikh and Dhruv Batra.

Contribution guidelines

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