Skip to content


Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
CodaLab Project
Python CSS JavaScript HTML F# Shell Other

CodaLab Build Status

What is CodaLab?

CodaLab is an open-source web-based platform that enables researchers, developers, and data scientists to collaborate, with the goal of advancing research fields where machine learning and advanced computation is used. CodaLab helps to solve many common problems in the arena of data-oriented research through its online community where people can share worksheets and participate in competitions.

To see CodaLab in action, visit



The CodaLab community forum is hosted on Google Groups.

Linux Quickstart

Assume the codalab-cli repository has been checked out at the same level as this directory and is called ../codalab-cli.

Install all the required Python packages:


Install the standard configuration file. Edit DATABASES if want to use MySQL instead of sqlite (need to create a MySQL database separately):

cp codalab/codalab/settings/ codalab/codalab/settings/

Update the database schema:

cd codalab
./manage syncdb --migrate
./manage config_gen

In development, CodaLab uses Less to generate CSS, which can be painfully slow. To turn this off, edit codalab/codalab/settings/ and make the following change:


Start the web server:

cd codalab

Create an account for codalab by navigating to http://localhost:8000, clicking Sign In, and Sign Up. Use any email address starting with codalab@. This account is just used so we can run the following script:

source venv/bin/activate
cd codalab
python scripts/

This script should print out a fragment of a JSON file with the appropriate keys, which should be added to the codalab-cli config file (usually ~/.codalab/config.json). This allows the bundle service to authenticate against the website. The JSON file looks something like this:

"auth": {
    "address": "http://localhost:8000",
    "app_id": "...",
    "app_key": "...",
    "class": "OAuthHandler"

Then start the bundle server:

../codalab-cli/codalab/bin/cl server

That is it!

Making codalab worksheets work offline

Need codalab to be able to render worksheets offline. Simple just run this command:

python prep_for_offline

This will download mathjax and install it in to the correct directories needed. Then simply add LOCAL_MATHJAX = True to your local settings.

Something went wrong with that request. Please try again.