# Visualize your dataset with the Bespoke Curator Viewer

{% hint style="warning" %}
IMPORTANT: We recently are retiring our local `curator-viewer` , now switching to a hosted Bespoke Curator Viewer. 
{% endhint %}

The hosted Bespoke Curator Viewer is a rich interface to visualize data, and makes visually inspecting the data much easier.

**Example**: 

Before your Curator run, set the `CURATOR_VIEWER` environment variable.

Bash:

```
export CURATOR_VIEWER=1
```

Python/colab:

```
import os
os.environ["CURATOR_VIEWER"]="1"
```

With this enabled, as curator generates data, it gets uploaded and you can see the responses streaming in the viewer. The URL for the viewer is displayed right next to the rich progress.

Then, run on any Bespoke Curator scripts, here we use `examples/poem-generation/poem.py` as an example, and 

<figure><img src="/files/4FMHeTHuad6iEjuqVy5z" alt=""><figcaption><p>Example Bespoke Curator Rich CLI logs on synthetic poems</p></figcaption></figure>

The line&#x20;

```
Curator Viewer: ✨ Open Curator Viewer ✨ 
```

contains a clickable link (the following is an example viewer link, the link changes for each new Curator generation run) which opens the hosted Bespoke Curator Viewer in a new browser tab:&#x20;

* <https://curator.bespokelabs.ai/datasets/845c7dd33b8b4242a24ff048b5f94354>

<figure><img src="/files/ER2sW4rgfyCz5fUl3lwh" alt=""><figcaption><p>Example Bespoke Curator Viewer on synthetic poem topics <a href="https://curator.bespokelabs.ai/datasets/845c7dd33b8b4242a24ff048b5f94354">link</a></p></figcaption></figure>

#### Authenticate with a Bespoke Labs API key

By default, datasets are accessible to anyone with the link. To keep your datasets private, you can associate them with a Bespoke Labs account. Doing so also allows you to:

* Track all datasets associated with your account
* Share datasets with collaborators
* Analyze data generation costs over time

You can enable authentication as follows:

1. [Sign up](https://curator.bespokelabs.ai/auth/signup) for a Bespoke Labs account.
2. Create an API key from the [API Key](https://curator.bespokelabs.ai/home/keys) page.

{% embed url="<https://screen.studio/share/9yMvXotK>" %}

3. Set the `BESPOKE_API_KEY` and `CURATOR_VIEWER` environment variables:

```
export BESPOKE_API_KEY=<YOUR_API_KEY>
export CURATOR_VIEWER=1
```

With these variables set, all your datasets will be streamed to the hosted viewer and linked to your Bespoke Labs account.

{% embed url="<https://screen.studio/share/x2s2ho3q>" %}

4. You can visit the [Datasets](https://curator.bespokelabs.ai/home/datasets) page to see all the datasets generated with your API keys or shared with you by others.

{% embed url="<https://screen.studio/share/cxyZKQw9>" %}

5. You can also visit the [Cost Report](https://curator.bespokelabs.ai/home/costs) page to see the data generation costs for a given period.

{% embed url="<https://screen.studio/share/91kpbunQ>" %}

<br>


---

# 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.bespokelabs.ai/bespoke-curator/getting-started/visualize-your-dataset-with-the-bespoke-curator-viewer.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.