Competitions documentation

Create a competition

Hugging Face's logo
Join the Hugging Face community

and get access to the augmented documentation experience

to get started

Create a competition

Creating a competition is super easy and you have full control over the data, evaluation metric and the hardware used.

To create a competition, you need to have a Hugging Face account. You will also need a write token which will be used throughout the competition to upload data and submissions. Please note that the write token is private and should not be shared with anyone and must not be refreshed during the course of the competition. In case you decide to refresh the token, you will need to update the token in the competition space’s settings otherwise the competitors will not be able to upload submissions and competition will stop working. You can find/generate a write token here.

To create a competition, you also need an organization. You can either create a new organization or use an existing one that you are already a member of. You can create a new organization here.

Please make sure you attach a payment method to your organization. You can do so in organization settings. NOTE: your payment method will not be charged if you are using the free tier of the platform (generic competitions hosted on CPU).

To create a competition, click here.

Competition creator

competition

Please note: you will be able to change almost every setting later on. However, we dont recommend changing evaluation metric once the competition has started. As it will require you to re-evaluate all the submissions.