# 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.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.adialab.crunchdao.com/participate/setup.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.