# Whitelisted Libraries

To prevent users from using malicious packages on the competition's infrastructure, a series of Python packages has been whitelisted.

The whitelist is also used when converting notebooks because some libraries have different names when imported than on PyPI. For example, `scikit-learn` is `sklearn`.

You can search the whitelisted library in the **Resources > Whitelisted Libraries** section of each competition.

## Requesting a package

You can request to whitelist packages via the "**Request whitelisting**" button in the "**Resources > Whitelisted Libraries**" section of each competition.

<figure><img src="/files/nD9fDVR1cvmqDwbX2OJg" alt=""><figcaption><p>Request to whitelist a library form</p></figcaption></figure>

Administrators need some information to find the package on PyPI and approve it.

* The **Name** is the package name on PyPI.\
  e.g.: `scikit-learn`
* The **Alias** is the name used in the Python code to access the package.\
  e.g.: `sklearn`
* The **GPU Requirement** is the hardware requirement to use the package:
  * If you are unsure, select **I don't know**.
  * If the package does not require a GPU at all, select **Useless for this library**.
  * If a GPU can be used but is not required, select **Can be useful for this library**.
  * If the package requires a GPU, select **Required for this library**.
* You can leave **Additional Details** if the package requires special attention, so the administrators can better understand why.

### Requirements

However, there are a number of requirements (pun intended) that must be met:

* The package must be available on [PyPI](https://pypi.org/).
* The package must have a good readme/documentation.
* The package must not be new (more than 6 months old).
* The package must have many downloads (e.g. [pandas](https://pypistats.org/packages/pandas)).
* The package must have [verified details](https://docs.pypi.org/project_metadata/) (by PyPI).

{% hint style="info" %}
We reserve the right to refuse a package if it looks suspicious.
{% endhint %}

### Package not on PyPI

If the package is only available on GitHub, you will need to download it and include it in your submission. Only PyPI packages are allowed.


---

# 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.crunchdao.com/competitions/participate/whitelisted-libraries.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.
