> For the complete documentation index, see [llms.txt](https://docs.adialab.crunchdao.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.adialab.crunchdao.com/participate/setup.md).

# Setup

**Two distinct formats of submission are accepted in this competition:**

* **Python Notebook (.ipynb)**
* **Python Script (.py)**

## Python Notebook Participants

This notebook is an example of a basic submission. It also covers how to set up and get access to the datasets:

{% embed url="<https://colab.research.google.com/github/crunchdao/adialab-notebooks/blob/main/basic_submission.ipynb>" %}
Basic Notebook Submission hosted on Google Colaboratory
{% endembed %}

{% embed url="<https://github.com/crunchdao/adialab-notebooks/blob/main/basic_submission.ipynb>" %}
Basic Notebook Submission hosted on Google Colaboratory
{% endembed %}

{% hint style="info" %}
We highly recommend going through this notebook to understand the setup and gain familiarity with the submission process.
{% endhint %}

Go to[ https://adialab.crunchdao.com/submit](https://adialab.crunchdao.com/submit?tab=notebook) and click on the *"reveal the command"* button to access the commands that will set up your personal workspace.&#x20;

<figure><img src="/files/4sWpLKv0MfiIxB2QS3sR" alt=""><figcaption><p>click in reveal the  to access your secure token and setup command</p></figcaption></figure>

Copy and paste the commands under the *"reveal the command"* overlay in your notebook to be able to access the data.&#x20;

Here is a quick description of each command:

```python
# Installs the crunch library in your workspace.
%pip install crunch-cli --upgrade

# To use the library, import the crunch package and instantiate it to be able to access its functionality.
# You can do that using the following lines:
import crunch
crunch = crunch.load_notebook(__name__)

# Authenticates your user, downloads your project workspace, and enables your access to the data
!crunch setup <username> --token <token>

# moves to the created working directory
%cd <username>
```

Note that the provided token acts as an authentication mechanism and has a duration of three minutes, after which it will become obsolete.&#x20;

## Python Script Participants

Go to [https://adialab.crunchdao.com/submit](https://adialab.crunchdao.com/submit?tab=cli) and click on *"reveal the command"* button to access the commands that will set up your workspace. Execute the commands in a terminal, in a working directory of your choice.

<figure><img src="/files/CTx5JDGapzC84Dq9qpRf" alt=""><figcaption><p>click in reveal the command to access your secure token and setup command</p></figcaption></figure>

## Tokens

The website generates new tokens every minute, and each token can only be used once within a 3-minute timeframe.

This prevents any issues if your token is accidentally shared because it will likely have already been used or expired.

This token allows the CLI to download data and submit it on your behalf.