# Troubleshooting

## Working With Aquarium in the Browser

<details>

<summary>The Embedding View Does Not Load/Button is Greyed Out</summary>

**If in Anonymous Mode:**

1. Did you upload custom embeddings?
   1. Embeddings must be uploaded for both your frames and ALL of your crops
   2. [Is your embedding vector <=2048 in length?](/aquarium/concepts/adding-custom-embeddings.md)
      1. If you would like to use an embedding vector longer than 2048 please contact Aquarium

**Non Anonymous or Anonymous Mode**

1. Aquarium requires you upload at least 101 images in order for us to start an embedding generation process for your data.&#x20;
2. Look at the **Streaming Uploads** tab under the **Project Overview** screen

   1. If the Embedding Status column does not say done, the embeddings are still processing. Depending on your dataset size the processing can take a while, if it takes longer than a few hours with a reasonable dataset size, feel free to reach out to Aquarium to see if something may be amiss

   <figure><img src="/files/cvp6OCjh7XRFbnZFh3DH" alt=""><figcaption></figcaption></figure>

</details>

## General Python Client Upload Errors

<details>

<summary><code>OSError: Attempting to flush dataset to disk with less than 1 GB of available disk space. Exiting...</code></summary>

The machine you are running the script from needs to have more than 1GB of available disk space before you run in order to complete an upload.

</details>

<details>

<summary>Uploading with Custom Embeddings<br><code>Error: This upload would exceed the following quota(s): Maximum Frame Embedding Length, Maximum Crop Embedding Length.</code></summary>

If you are uploading custom embeddings, the vector length defaults to 2048. This error is likely due to your embedding vector length being greater than 2048. If you would like to use a larger embedding, please contact Aquarium to adjust your maximum embedding length allowance.

</details>

<details>

<summary><code>Waiting for inferences to finish processing...</code><br><code>Waiting for dataset to finish processing...</code></summary>

If you see this error in your console when you&#x20;

</details>

## Semantic Segmentation Data Upload Errors

<details>

<summary><code>Mutable streaming datasets do not support mask_data for semseg masks yet.</code></summary>

If you upload your mask data as a ndarray of pixel mask data, you do have to explicitly upload your data using our `BATCH` methodology. If possible, we better support using `mask_url` to upload a greyscale image form of your mask data. Our `BATCH` methodology is only used for uploading semseg data via `mask_data` right now, please reach out to the Aquarium team for assistance.&#x20;

</details>

## Working with Aquarium from a Jupyter Notebook

<details>

<summary><strong><code>InvalidResponse: ('Request failed with status code', 201, 'Expected one of', &#x3C;HTTPStatus.OK: 200>)</code></strong> </summary>

This error most commonly manifests when running an upload for the first time, shortly after installing the `aquariumlearning` package in your notebook python environment.\
\
This occurs due to an older version of a package we depend on `google-resumable-media`, being sourced in your environment. &#x20;

The **Solution** is to restart your notebook kernel after installing the `aquariumlearning` package for the first time. This can be done by restarting the kernel manually, or running the following in&#x20;

```python
import importlib
importlib.reload(al)
```

</details>


---

# 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://legacy-docs.aquariumlearning.com/aquarium/concepts/troubleshooting.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.