Skip to main content

Jupyter Storage Explorer

Explore your data lake without leaving Jupyter: built for data professionals

PyPI - Version codecov Try it on Binder

StorageExplorer is a file explorer for cloud storage and data lakes, right inside Jupyter, in the spirit of Azure Storage Explorer. See Using the explorer.

Storage Explorer in JupyterLab: a Delta Lake table queried, files filtered, and a Markdown file edited in JupyterLab's editor and previewed

DataExplorer browses any dataframe in your notebook: pandas, polars, Spark, DuckDB and more. See Using the data browser.

DataExplorer in a notebook: a Parquet file paged through, columns hidden, filtered and sorted

Highlights

  • StorageExplorer: one explorer to browse them all. S3, Azure, Google Cloud Storage, local disks and anything else fsspec reaches, side by side.
  • DataExplorer: a table widget for your dataframes, more than meets the eye. Page, sort and filter large tables in your data lake, and get the result back in code.
  • Launcher: right at home in your Jupyter. Open the explorer in a tab or in the side panel, edit storage files, and copy and paste or drag and drop files between explorers, and more.
  • Previews: look before you load. Delta Lake, Parquet, CSV, JSON, Excel, text and images open at a click, with ready-to-run code that loads them into your notebook.
  • Plugin support: data professionals, start your engines. Plug your favourite data library, such as Polars, pandas or PySpark, into the explorer, and browse data with it on the fly. Not supported yet? You, or your AI assistant, can write a plugin for it: see Developing plugins.
  • Safe file operations: keep calm and copy on. Copy, move and delete large folders in the background, with progress and Cancel. Folder operations wait for Unsafe mode, and transfer rules keep data where it may go.
  • Bookmarks: there and back again. Bookmarks and remembered queries bring you back where you left off.

Quick start

Try it without installing anything: open the demo on Binder, a made-up data lake in a notebook and in the launcher's tab (it may take a minute to start).

From the JupyterLab launcher

jupyter-storage-explorer-launcher adds Storage Explorer to JupyterLab's launcher, opening the explorer in its own tab, and to the left side bar:

pip install "jupyter-storage-explorer-launcher[polars]"

The Storage Explorer item in JupyterLab's launcher

From Python code

pip install "jupyter-storage-explorer[polars]"

[polars] adds the Polars plugin with Polars itself; other engines and storages are extras too, e.g. [polars-support] for the plugin alone, using the libraries you have (recommended in carefully set up kernels). See Plugins for all of them, and Installation for the storage packages.

from jupyter_storage_explorer import StorageExplorer

StorageExplorer("s3://my-bucket/data")

Options after the address go to the storage package, e.g. profile="analytics". Double-click a file to preview it; right-click for everything else. With the launcher installed, files that JupyterLab can show open in its editors instead.

Browse a dataframe and get the rows you filtered back:

import polars as pl
from jupyter_storage_explorer import DataExplorer

explorer = DataExplorer(pl.scan_parquet("s3://my-bucket/lake/sales/*.parquet"))
explorer
explorer.result().collect()  # after filtering and sorting in the widget

The notebooks folder has a demo of each widget on sample data.

Documentation

  • StorageExplorer: storages, using the explorer, transfer policy, formats, working with it from Python and options.
  • DataExplorer: the data browser, result(), on_change(), QuerySettings and options.
  • The launcher: configuring its tab with launcher.py files.
  • Development: building, releasing, and custom icons.
  • Developing plugins: formats, engines, file operations and storages of your own, packaged as plugins.

Requirements

  • Python 3.11 or later
  • JupyterLab 4.0 or later (other Jupyter frontends show the widgets, without drag and drop from JupyterLab's file browser)
  • For querying data: an engine plugin, e.g. jupyter-storage-explorer[polars] (Polars, tested with 2.0)

Why Storage Explorer?

A data-aware file explorer for large data lakes, in JupyterLab's main area (a notebook or a tab), with room for what working with data needs; it complements JupyterLab's file browser rather than replacing it.

  • Large folders: paged, sorted and filtered as you type; tens of thousands of items listed by the kernel; file operations in the background, with progress and Cancel.
  • Tables, not just files: Delta Lake tables and partitioned Parquet datasets open in the data browser, queried where they live with the engine you choose.
  • From browsing to code: ready-to-run code and URLs for what you select; your code can follow what you browse (from Python).
  • At home in JupyterLab: drag files to and from its file browser and between storages; edit files in its editors; keep an explorer in its side bar, beside your notebooks (the launcher's side panel).
  • Safe by default: folders are moved, copied, renamed or deleted only in Unsafe mode, for one operation.
  • Runs in your kernel: with your credentials and your libraries, and no server setup.

Metadata

Release files for jupyter-storage-explorer 0.21.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for jupyter-storage-explorer 0.21.0
File Size Uploaded Provenance
jupyter_storage_explorer-0.21.0.tar.gz 2.1 MB With provenance Details

Built distribution (wheel)

Table of built distributions (wheels) for jupyter-storage-explorer 0.21.0
File Interpreter ABI Platform
jupyter_storage_explorer-0.21.0-py3-none-any.whl Python 3 none any Details

Total release size: 2.4 MB

Release files / jupyter_storage_explorer-0.21.0.tar.gz

Download URL jupyter_storage_explorer-0.21.0.tar.gz
Size 2.1 MB
Tags Source
SHA-256 checksum
How to use checksums
ab56354117c1b959b693aa43c2a3ccc01cd7d3f5835ce383f15b383faf60e12d
BLAKE2b-256 checksum
How to use checksums
b182f561d6093b3bd0cd000aed3937cb2f17bfcb5379857e04e8282c9c1d252f
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 23, 2026.

Transparency log

Release files / jupyter_storage_explorer-0.21.0-py3-none-any.whl

Download URL jupyter_storage_explorer-0.21.0-py3-none-any.whl
Size 327.8 kB
Tags Python 3
SHA-256 checksum
How to use checksums
7c04e66f66c257f1db371fee44186b701d14e763b9983b7c9cd4e1e16336b401
BLAKE2b-256 checksum
How to use checksums
1f2a71b681f5a0965773d7dd4bce7deb1cde5891ad75ce60cd44536b08fa21b9
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 23, 2026.

Transparency log

Security for jupyter-storage-explorer 0.21.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

All 2 files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for jupyter_storage_explorer-0.21.0.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 23, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.21.0 This release

2 release files Full provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page