# Installation

## Package Overview

Tilebox offers a Python SDK for accessing Tilebox services. The SDK includes separate packages that can be installed individually based on the services you wish to use, or all together for a comprehensive experience.

[tilebox-datasets](https://pypi.org/project/tilebox-datasets/)

Access Tilebox datasets from Python

[tilebox-workflows](https://pypi.org/project/tilebox-workflows/)

Workflow client and runner for Tilebox

[tilebox-storage](https://pypi.org/project/tilebox-storage/)

Read and download assets from object storage

## Installation

Install the Tilebox python packages using your preferred package manager.

For new projects Tilebox recommend using [uv](https://docs.astral.sh/uv/).

**uv**

```bash title="uv"
uv add tilebox-datasets tilebox-workflows tilebox-storage
```

**pip**

```bash title="pip"
pip install tilebox-datasets tilebox-workflows tilebox-storage
```

**poetry**

```bash title="poetry"
poetry add tilebox-datasets="*" tilebox-workflows="*" tilebox-storage="*"
```

**pipenv**

```bash title="pipenv"
pipenv install tilebox-datasets tilebox-workflows tilebox-storage
```

## Setting up a local JupyterLab environment

To get started quickly, you can also use an existing Jupyter-compatible cloud environment such as [Google Colab](https://colab.research.google.com/).

If you want to set up a local Jupyter environment to explore the SDK or to run the [Sample notebooks](/docs/sdks/python/sample-notebooks) locally, install [JupyterLab](https://github.com/jupyterlab/jupyterlab) for a browser-based development environment. It's advised to install the Tilebox packages along with JupyterLab, [ipywidgets](https://ipywidgets.readthedocs.io/en/latest/user_install.html), and [tqdm](https://tqdm.github.io/) for an enhanced experience.

```uv title="uv"
mkdir tilebox-exploration
cd tilebox-exploration

uv init --no-package
uv add tilebox-datasets tilebox-workflows tilebox-storage
uv add jupyterlab ipywidgets tqdm
uv run jupyter lab
```

### Trying it out

After installation, create a new notebook and paste the following code snippet to verify your installation. If you're new to Jupyter, you can refer to the guide on [interactive environments](/docs/sdks/python/sample-notebooks#interactive-environments).

```python title="Python"
from tilebox.datasets import Client

client = Client()
datasets = client.datasets()

collection = datasets.open_data.aws_earth.sentinel2.collection("L2A")
data = collection.query(temporal_extent=("2025-01-01", "2025-01-02"), show_progress=True)
data
```

If the installation is successful, the output should appear as follows.

![Local JupyterLab](/docs/assets/jupyter/local-jupyter-light.png)

![Local JupyterLab](/docs/assets/jupyter/local-jupyter-dark.png)