Home

User manual

CodaLab Competitions is a powerful open source framework for running competitions that involve result or code submission. You can either participate in an existing competition or host a new competition. Most competitions hosted on CodaLab are machine learning (data science) competitions, but CodaLab is NOT limited to this application domain. It can accommodate any problem for which a solution can be provided in the form of a zip archive containing a number of files to be evaluated quantitatively by a scoring program (provided by the organizers). The scoring program must return a numeric score, which is displayed on a leaderboard where the performances of participants are compared.

To see CodaLab Competition's in action, visit codalab.lisn.fr.

Table of contents

1. Participants
2. Organizers
3. Developers and administrators
4. How you can contribute
5. How to contact us

1. Participants

• User Settings
• List of Current Competitions
• Participating in a Competition
• Joining a Team
• Frequently Asked Questions (FAQ)

2. Organizers

2.1. Organizers using the public CodaLab instance

The public instance of CodaLab may be used to organize research or education competitions within the limits of our hosting capabilities. For code submission competitions, please contact us: you may have to supplement CodaLab with additional computer workers.

• How to create your first competition on CodaLab
• What does it take to organize a competition? (ChaLearn tips)
• Complete organizer guide, in which you'll learn how to build a competition bundle, write a scoring program, use Docker and more. Everything you need to organize your own competition!

2.2. Organizers providing custom "compute workers"

If your competition needs extra computational power, you can easily add to the backend of the public CodaLab instance your own server(s) to process participant submissions.

• Understanding the CodaLab architecture
• Using your own compute workers
• Protocol for testing queues
• Administering compute workers using Fabric

2.3. Organizers who want to run their own instance

This section explains how to run your own CodaLab instance (front-end and back-end). This allows you to customize CodaLab and have full control and full privacy. We prepared for you a re-usable AWS virtual machine image (called AMI), already pre-configured, thus easier to install. You can also install CodaLab from scratch on your own server. Before you venture into doing this, check "Customizing your website" in section 2.1 and the previous section, which may suffice to customize CodaLab for your needs.

• Guide: deploying your own instance

3. Developers and administrators

Developers should first go through section 2.3.

• Administrator procedures (get admin privileges, erase or rename user, etc.)
• API Reference
• Developer Guidelines
• Instance debugging & testing
• Executing jobs
• Configure CodaLab to work with Visual Studio
• Configure settings
• Groups and Permissions
• Database migration
• Code checker
• Developer reference manual (work in progress, will be ready for v2)
• Production Server Settings (disable default worker, backup database)
• Disaster recovery instructions [Production server]

4) How you can contribute

• Use CodaLab Competitions by either participating in a competition or hosting a new competition.
• Find a bug? Got a feature request? Submit a GitHub issue. Follow the Process for Bugs and Issues.
• Submit pull requests on GitHub to implement new features or fix bugs. Follow the Developer Guidelines.
• Improve this documentation. Follow these instructions to add images.
• Let others know about CodaLab!

5) How to contact us

• The preferred way is via posting a GitHub issue. See instructions.
• In case of emergency, contact us directly.
• If you wish to get in touch with the community, you can use the Google Groups.